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PREFACE 


This manual describes the features of the MU BASIC/RT-11 system and 
the enhancements made to the BASIC-11 language for this system. 
BASIC-11 is DIGITAL's name for a family of BASIC! systems on the 
PDP-ll. The reader is assumed to be familiar with the BASIC-11l 
Language Reference Manual (DEC-11-LIBBA-A-D), which describes the 


features common to all versions of BASIC-1l. 


All users of an MU BASIC/RT-11 system should read this manual. Chap- 
ter 1 provides an introduction to the system and summarizes the 
enhancements of BASIC-11. Chapter 2 describes file manipulation and 
the input and output features available. Special system functions and 
commands are described in Chapter 3. Error messages are listed in 
Chapter 4. Appendix A lists the standard ASCII (American Standard 
Code for Information Interchange) characters. Appendix B contains 

a complete summary of all statements, functions, and commands. 
Appendix C describes the virtual array capability. The documentation 
conventions used in this manual are described in Appendix B. 

This manual assumes that the MU BASIC/RT-11 system is operational. 

The information to start and maintain an MU BASIC/RT-11l system can be 
found in the MU BASIC/RT-11 System Installation Guide (DEC-11-LIBMA-A-D), 
but users who interface only with a working MU BASIC/RT-11 system do 


not need access to this guide. 


‘BASIC is a registered trademark of the Trustees of Dartmouth College. 
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CHAPTER 1 


INTRODUCTION 


MU BASIC/RT-11 is a multiuser BASIC-1l system, capable of accommodat- 
ing up to eight users simultaneously. Each user independently creates 
and executes BASIC-11 programs. All the features of the MU BASIC/RT-11 
system, including statements, commands, functions, and immediate mode, 


are available to all users. 


MU BASIC/RT-11 runs under the RT-1l monitor. Users can access any 
RT-ll-supported device, including disk, DECtape, magtape, cassette, 
card reader, high-speed paper tape reader/punch, and line printer. 


Throughout this manual the term BASIC refers to both the BASIC-11 lan- 
guage and to the MU BASIC/RT-11 System. 


1.1 GETTING STARTED 

To get started on an MU BASIC/RT~-11 system it is first necessary to 
determine whether the system includes the HELLO feature. The HELLO 
feature restricts access to the system to authorized users. 

See the system manager of your installation to determine whether the 
HELLO feature is present. If the HELLO feature is not present, go to 
section. Jele2< 


1.1.1 Getting Started on Systems with the HELLO Feature 


To get started with BASIC, it is necessary to get a user ID and a pass- 


word from the system manager. Without a user ID and a password, it is 
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impossible to run any BASIC programs. The user ID is a 2-character 


alphanumeric code. For example: 


F7 


A password can be up to six characters long. For example: 


PASED 


The combination of valid user ID and password allows access to the 


system. 


When the BASIC system has been started by the system manager, it prints 


on all terminals: 


MU BASIC/RT-11 IS ON THE AIR! 


PLEASE SAY HELLO 
The log-on procedure is the method by which a user gains access to the 
BASIC system. To log on, type HELLO and press the RETURN key. If 
anything not beginning with the letter "H" is typed, BASIC prints: 
PLEASE SAY HELLO 
After HELLO has been typed, BASIC prints: 
USERID: 
Type your user ID and press the RETURN key. BASIC then prints: 
PASSWORD: 
Type the password assigned and press the RETURN key. The characters 
that are typed are not displayed on the terminal. This ensures the 
privacy of the user ID-password combination. 


If the user ID and password entered are not valid, BASIC prints: 


INVALID ENTRY -~ TRY AGAIN 


USERID: 


=) 
{ 
ho 
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If this message appears, the user ID and password must be reentered. 
This message is often caused by typing errors. 


If the user ID and password are valid, BASIC prints an informational 


message. For example: 
WELCOME TO MU BASIC/RT-11 
Then BASIC prints: 
READY 
This indicates that the user may enter any BASIC command, immediate 
mode statement, or program line. To terminate the session, use the 


BYE command (see section 1.1.3). 


NOTE 


The CTRL/O key command terminates output 
to the terminal and can be used during 
the log-on procedure to avoid the print- 
ing of the informational message. 


1.1.2 Getting Started on Systems Without the HELLO Feature 


When the BASIC system has been started by the system manager, it prints 
on all terminals: 


READY 
This indicates that the user mav enter any BASIC command, immediate 
mode statement, or program line. The user ID of all users is AS and 
all users are privileged (see section 1.2). The HELLO command is not 
recognized and produces a ?SYN (SYNTAX) error message. 
To terminate the session, use the BYE command (see section 1.1.3). 
1.1.3 Terminating the Session - the BYE Command 


To terminate a session at the terminal, type 


BYE 
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and press the RETURN key. The BYE command deletes the current user's 


program and deassigns all devices assigned to the current user. 


On systems with the HELLO feature, BYE prints a message and then ini- 


tiates the log-on procedure. The message is: 
USERID xx LOGGED OFF -- GOODBYE 
PLEASE SAY HELLO 

where xx is the user ID of the current user. 


On systems without the HELLO feature, BYE causes BASIC to print the 
READY message. 


1.2 RESTRICTED OPERATIONS 


Certain operations are restricted, to prevent one user from interfer- 
ing with other users' programs and files. Some operations are not 
allowed for any user, while other operations allowed for a privileged 
user are not allowed for a nonprivileged user. The system manager 


determines which users are privileged and which are nonprivileged. 


The following lists the operations that are restricted to privileged 
and nonprivileged users. Nonprivileged users can temporarily execute 
any operation allowed to privileged users when running a privileged 


program. See Section 2.3 for more information on privileged programs. 


Operation Nonprivileged User Privileged User 
File Access Restricted by file Unrestricted 


protection system 
(see section 2.3) 


Maximum number Restricted by sys- Restricted only by 
of simultaneously tem manager system's resources 
open files 


Maximum size of Restricted by sys- Restricted only by 

output data file tem manager available free 
space on the de- 
vice 


Introduction 


Operation Nonprivileged User Privileged User 
Nonfile-structured Not allowed Only prohibited when 
open of a file- a public device is 
structured device opened for output 
(see section 2.5.1.2) in a nonfile-struc- 


tured manner 
Execution of sys- Certain functions Unrestricted 


tem functions are not allowed 
(see section 3,4) 


1.3 ENHANCEMENTS TO BASIC-11 


There are several features in MU BASIC/RT-1l that are not described in 
the BASIC-11 Language Reference Manual. All new and changed features 


are summarized in Tables 1-1, 1-2, and 1-3. 


The precedence of arithmetic operators is slightly different than that 


described in the BASIC-1l Language Reference Manual. Specifically, 
in the absence of parentheses MU BASIC/RT-11 has this order of 


prLority: 

a 

By Unary minus 
For example, 


K=3 \N PRINT ~2° 29 -X7272°-2 
we Oh -~9 7 2 


af 


REATIY 


The priority described in the BASIC-1l Language Reference Manual pro- 


duces values of +4 and +9 for the first two operations. The third 
operation (2+t-2) produces the same values under both sets of 
priorities. Operations involving both exponentiation and unary minus 
should, in general, be enclosed in parentheses to avoid confusion. 
The immediate mode statement should be rewritten as: 


X=Bo\ PRINT ~ (2% 2) 9- CX" 2) y B"H 2) 
a ag 25 


REATLIY 


Table 1-1 
Enhancements to BASIC-11 Commands 


Key command; stops execution of the BASIC-11l state- 
ment or command, prints the following: 


AC 
STOP AT LINE xxxxx 


rupted, the AT LINE is not included. CTRL/C can 
be disabled by special system function calls (see 
section 3.4.6). The response to CTRL/C may not be 
immediate if input or output is in progress. 


CTRL/Q Key command; continues output to terminal after 


CTRL/S. May be labeled XON on some terminals. 
CTRL/S Key command; suspends all output to terminal until 
CTRL/Q, CTRL/O or CTRL/C is typed. May be labeled 
XOFF on some terminals. 

CTRL/U Deletes the entire line currently being entered. 
BASIC prints: 


4U 
ASSIGN device: 


Assigns specified device to user if it is avail- 


READY 
If a command or immediate mode statement is inter- 

| 
able. 


DEASSIGN [device:]] Deassigns specified device or all devices if none 


is specified. 


HELLO Special command to gain access to the MU BASIC/ 
RT-1l system. Not available on all systems. 

KEY Enables echoing after TAPE command or SYS(1) or 
SYS(3) system function call. 

LENGTH Displays the amount of memory used by the current 


program, expressed as number of words. 


SET TTY type Sets system to allow different terminals; type may 
be VT05, ASR33, or LA30. 
TAPE Disables echoing and enters special mode to allow 


use of the low-speed paper tape reader. 


UNSAVE file 
descriptor 


BYE Terminates the user's session. 
| Deletes specified file. 


| 
| 
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Table 1-2 
Enhancements to BASTC-11 Statements 


Meaning 


| Statement 


| KILL string | Deletes specified file. 


| 
| LET VF int | Special form of LET statement for use with virtual 
(exprl)=expr2 | array files. 
NAME stringl TO Renames specified file. 
string2 
OPEN Opens data files; has new keywords for device op- 


timization and special form for virtual arrays. 


Table 1-3 
Enhancements to BASIC-11 Functions 


Meaning 


| sys System function calls; to control output to ter- 
minal and perform system operations. | 

| 

! 


column. If the column number specified is less 
than the current position, a carriage return with- 
out a line feed is printed and printing starts at 
the specified position on the same line (instead 
of resuming printing at the current position as 
described in the BASTIC-11 Language Reference Manual 


| 
TAB Causes the terminal head to move to specified 


1.4 ASSEMBLY LANGUAGE ROUTINES 


Any assembly language routines that the system manager has included 
with MU BASIC/RT-11 can be executed by the BASIC-11 CALL statement. 
The CALL statement, including the implied call format, is described 
in the BASIC-1l Language Reference Manual. The system manager can 
provide further information on assembly language routines included 


(1h vahig) x 


CHAPTER 2 


INPUT AND OUTPUT 


Z2e1, MU BASIC/RE a1) ELLES 


The MU BASIC/RT-11 file capability allows data and BASIC programs to 
be stored for future use. Programs that access files can manipulate 
data much faster and in larger amounts than programs that perform 
terminal input and output only. Saving programs in files makes it 
possible to restore them at a later time. Another program can run a 


saved program by means of the CHAIN or OVERLAY statement. 


Data is stored either in sequential files or in random-access, virtual 
array files. Sequential files are treated in the same way as terminal 
input/output -- data is read by an INPUT statement and written by a 
PRINT statement. Sequential files are useful for storing data that is 
to be processed serially. Virtual array files are similar to arrays 
stored in memory. An element of data in a virtual array can be part 

of any BASIC expression just the same as an element of a normal array. 
An element of a virtual array file can be assigned a value by a special 
form of the LET statement. Virtual array files allow data to be ac- 
cessed in a random, non-serial manner and are the only BASIC files in 


which existing data can be updated without rewriting the entire file. 


Each user creates and accesses files independently. A user creating 
a file can allow others to access the file or can restrict access to 
it. A privileged user can create a public or group library file that 
can be convenientiy accessed by many users. Ail users can access pub- 
lic files whereas group files are only available to a specific group 


of users. 
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BASIC files can be created and accessed on any device supported by the 
RT-11 Monitor and included by the system manager in the BASIC system. 
Among the devices that may be included in the system are disk, DECtape, 
cassette, industry-compatible magtape, card reader, line printer, and 


high-speed paper tape reader/punch. 


NOTE 


Files can only be created on cassettes, 
disks, DECtapes, and magtapes that have 
been previously zeroed by the RT-11l PIP 
program. See your system manager or the 
RT-11 System Reference Manual for informa- 
tion on PIP. 


2+2 FILE DESCRIPTOR 
BASIC files are created and accessed by file control commands and state- 


ments. A file is specified by means of a file descriptor in the gen- 


eral form: 


(devices) [ #]tsitenanel {. fextension! 
@ 


where: 
device: is a legal apbreviation representing a device and 
may be any abbreviation listed in Table 2-1. 
$ denotes a public file. 
# denotes a group file. 
@ denotes a private file (default). 
filename is the l- to 6-character name of the file. 
extension is the 1- to 3-character extension of the file. 
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Table 2-1 
Device Name Abbreviations 


Abbreviation | Represents 


CR: Card reader. 


CT [digit]: Cassette (unit number specified by digit). 


System device {unit specified by digit). 


| DK{digit]: System device (unit specified by digit). 
DT [digit]: DECtape (unit specified by digit). 
KB: User's terminal. 
LP: Line printer. 
MT [digit]: Magtape (unit specified by digit]. 
PP: High-speed paper tape punch. 
PR: High-speed paper tape reader. 
ee Fixed-head disk. 
| RK[{digit]: RK11 cartridge disk (unit specified by digit). 
| SY[digit]: | 


evices listed in Table 2-1 any permanent device 
names added to the RT-11 Monitor can be used from BASIC. See the 
system manager for the devices and device name abbreviations that are 


available. 


It is not necessary to specify the device. When the device is not 
specified the system device is assumed. The system device can only 
be disk or DECtape. 


NOTE 


The optional digit in the device specifi- 
cation represents the device unit number. 
If the optional digit is omitted from SY 
or DK, the system device (unit from which 
system was bootstrapped) is assumed. If 
the optional digit is omitted from any 
other device name, unit @ is assumed. 


There are three classes of files: 


Public library files 
Group library files 
Private files 
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Public library files are accessible to all users. Programs that will 
be accessed by many users may be placed in the public library. In- 
cluding a dollar sign ($) in a file descriptor specifies a file in the 
public library. Public library files are stored internally as files 


with only one-character extensions. 


Group library files are accessible to a group of all users having the 
same first character in their user ID. For example, users with the 
user ID's H9, HF, HO, and HZ belong to the same group (H is the group 
character). A group library file is specified by including a number 
sign (#) in the file descriptor. Group library files are stored in- 
ternally with a two-character extension. The second character of the 


extension is the group character. 


A private file is accessible only to the user who has created it. A 
private library file can be specified by including the at sign (@) or 
by not including any of the special file class symbols (S$, # and @). 
A private file is stored internally as a file with a three-character 
extension. The second and third characters of the extension are the 


characters in the user ID of the user who created the file. 
2.2.2 Filename and Extension 


When the specified device supports named files (disk, DECtape, cassette, 
and magtape support named files) the filename and extension specify 

the individual file on the device. Only one permanent file with a 
particular filename and extension can exist on a given device. If a 
new file is created on a device with the same filename and extension 

as a file already existing on that device, the old file is deleted 

when the new file is made permanent (closed). But files with the same 
filename and extension can exist on different devices; they are com- 


pletely independent. 


For the line printer, high-speed paper tape reader/punch, card reader, 
or terminal, which do not support named files, any specified filename 


and extension are ignored. 


If a filename is not specified in a SAVE, REPLACE, or UNSAVE command, 
the current program name is the assumed filename. If any of the file 
descriptors in a KILL or NAME TO statement are missing tne filename, 


the current program name is also assumed. The OPEN statement does not 
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specified, then a nonfile-structured OPEN is attempted (see section 
2.5.1.2). All other statements and commands (APPEND, NEW, OLD, RENAME, 
CHAIN, and OVERLAY) assume the default filename "NONAME" when none is 


ananmi 


rh 


An extension specification is necessary only when accessing a private 
file of another user, a group file of another group, or a file that has 


a nonstandard extension. 


The first character of the extension depends on the type of file. If 
the file is a BASIC program (OVERLAY and CHAIN statements and APPEND, 
OLD, REPLACE, RUN, SAVE, and UNSAVE commands) the first character of 
the standard extension is B. If it is a data file (OPEN, NAME TO, and 


KILL statements) the first character of the standard extension is D. 
The extension actually used by BASIC is dependent on: 


the type of operation involved 
the user ID of the current user 
the extension specified (if any) 


the class of the file (determined by S$, #, or @) 


The type of operation involved determines whether the first character 
of the extension is D (for data file operations) or B (for BASIC pro- 


gram operations) unless an extension is specified. 


The user ID of the current user becomes the second and third characters 
of the extension actually used unless an extension is specified or a $ 


or # is specified. 


If an extension is specified, then that is the actual extension used 


unless a S$, #, or @ is specified. 


If a file class is specified by a $, #, or @, then it determines the 
second and third characters of the actual extension used. If $ is 
specified (public library file), then the second and third characters 
are nulls. If # is specified (group library file), then the third 
character is a null. And if @ is specified (private file), then the 
second and third characters of the extension actually used are the 


user ID of the current user (see examples below). 
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The following list contains file statements and commands and the de- 
vice, file name, and extension they will attempt to access. The access 


may be restricted by the file protection system (see section 2.3). 


These examples assume the current user ID is B9, and the current pro- 


gram name is EVENT. 


File Statement or 


Command File Specified Comment 
OPEN "DATA" AS FILE #1 SY:DATA.DB9 The system device is as- 


sumed, the file name is 
specified, the first char- 
acter of the extension is 
D because OPEN is a data 
file statement and the 
last two characters are 
the current user ID. 


SAVE DT1: DT1:EVENT.BB9 The device is specified, 
the program name is the 
file name, the first char- 
acter of the extension is 
B because SAVE is a BASIC 
program file command, and 
the last two characters 
are the current user ID. 


OLD $SPROGRM SY:PROGRM.B The system device is as- 
sumed, the file name is 
specified, the first char- 
acter of the extension is 
B because it is a program 
file statement, and there 
are no second and third 
characters because it is 
a public library file. 

The program name becomes 


PROGRM. 
OPEN "#MONEY.G" AS SY:MONEY.GB The system device is as- 
FILE #2 sumed, the filename is 


specified, the first char- 
acter of the extension is 
specified, and because # 
specifies a group file, 
the second character is 
the group character and 
there is no third char- 
acter. 


OLD PR: PR: The papertape reader does 
not need a filename or ex- 
tension. The program 
name becomes the default 
NONAME. 
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File Statement or 
Command 


File Specified 


OPEN "DT1:ABC.HB9" AS FILE 1 
OPEN "DT1:@ABC.H" AS FILE l 
OPEN "DT1:@ABC.HHH" AS FILE 1 


DT1:ABC.HB9 


OPEN: “STORER” AS: FILE Fl S¥*STORE:. R 


OPEN "STORE" AS FILE #1 SY:STORE.DB9 


OPEN “STORE." AS FILE #1 SY:STORE. 


OLD DT@#:77GAME.B7R DT#:77GAME.B7R 


Comment 


These statements are equi- 
valent. The first state- 
ment specifies the file 
descriptor exactiy. The 
second specifies the @, 
filename, and first char- 
acter of the extension; 
the @ causes the second 
and third characters of 
the extension to be the 
current user ID. The 
third is the same as the 
second except that a three 
character extension is 
specified, but the second 
and third characters speci- 
fied are ignored because 
of the presence of @. 


The system device is as- 
sumed and the filename and 


extension are specified 
exactly. This is a pub- 


lic library file because 
the second and third char- 
acters of the extension 
are nulls. 


The system device is as- 
sumed and the filename is 
specified. The first char- 
acter of the extension is 

D because OPEN is a data 
file statement, and the 
last two characters of the 
extension are the current 
user ID because a private 
file is assumed. 


The system device is as- 
sumed and the filename 
(STORE) and extension (the 
null extension) are speci- 
fied. 


Another user's private 
file can be accessed only 
by specifying the exten- 


ea2gtan 
WOaiWile 


Input and Output 


NOTE 


When the user ID is AS the default exten- 
sion for data files is ".DAT" not ".DAS". 
AT are the last two characters of the ex- 
tension in a data file statement only 
when neither the extension nor the file 
class is specified. The last two charac- 
ters of the extension in a BASIC program 
operation or when @ is specified are the 
normal AS. This feature allows compati- 
bility with the default extensions in 

the single user BASIC/RT-1l. 


2.3 FILE PROTECTION SYSTEM 


There are several degrees of file access allowed: 


[ Run allows access by the RUN command or CHAIN state- 
ment. 
Z Read allows access by the OLD or APPEND command or the 


OPEN FOR INPUT or OVERLAY statement or use of the 
value of an element of a virtual array. 


3 Update allows access by the LET VF statement -- can only 
be done to virtual array files. 


uy Complete allows access by all of the above and by the SAVE, 
REPLACE, or UNSAVE command or the OPEN FOR OUTPUT, 
NAME TO, or KILL statement. 


A nonprivileged user is allowed complete access only to the user's own 
private files. A nonprivileged user can have Run and Read access to 
files in the public library and the user's own group library. No ac- 
cess is allowed (for a nonprivileged user) to other users' private 
files and files in other groups' libraries. The access allowed a non- 
privileged user to all files other than the user's own private files 


can be modified by the inclusion of a protection code in the filename. 


A privileged user has complete access to all files. Group library and 
public library files can only be created by a privileged user. 


When one of the four digits, 6, 7, 8, and 9, occurs in the first or 
second character position of a filename it has a special file access 
meaning. The first character determines the access allowed all users 
in the group, specified by the second character of the extension of 

the file. The ,second character of the filename determines the access 
allowed for all other usersy In public library files, the first char- 


acter position determines the access allowed for all users. The 
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following list describes the meaning of the digit 6, 7, 8, or 9 in the 


first or second character position. 


Digit Meaning 


6 Run, read, and update access. Allows all access except 
creating. 6 is only useful for virtual array files. 


7 Run and read access. 
8 Run access only. Program erases the user's storage 


area when it terminates execution (except when run by a 
privileged user). 


9 Run access only. Program erases the user's storage area 
when it terminates execution (except when run by a 
privileged user). Same as 8 except that the program 


can perform any privileged file operation or system 
function even when run by a nonprivileged user. 


Any other character in the first or second character position of a 
filename of a private file specifies no access allowed for users other 


than the file's creator. 


Any other character in the first character position of a filename for 
a group file specifies read and run access (equivalent to specifying 7} 
to users in the group. Any other character in the second position 


specifies no access for all users not in the group. 


Any other character in the first character position of a filename of 
a public library file specifies read and run access (equivalent to 


specifying 7). 


A 9 in the first or second character position of a filename allows a 
nonprivileged user executing the program to perform any operation that 
a privileged user can. Only a privileged user can create a file with a 
9 in the first or second position. It is important that any such pro- 
grams be carefully coded to ensure privacy of confidential information. 
Because the program deletes itself on any program termination, includ- 
ing the CTRL/C key command and error conditions, there is no danger 


that a nonprivileged user can alter it. 
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NOTE 


A privileged user can run, read, update, 
or create any file. Only a privileged 
user can create group and public library 
files (with the exception that a non- 
privileged user with a one-character 
user ID can create group library files). 


Examples: 


Filename 


File can be read, run, ee, PEGE eee Private file created by 


and updated by users c— user with user ID Al. 
in Group A. 

File can only be read Data file. 

or run by other users. 


Program can only be ee BE BASIC program in public 
run; while it is exe library. 


cuting any privileged 
operation can be per- 
formed. 


All users in group 5 78ACNT.B5 Group library file for 
can read or run 4 | L——~"_ group ae 

Other users can not read BASIC program. 

file; they can only run 

it. Program will erase 


itself when it terminates 
execution. 


2.4 \BASIC PROGRAMS)IN FILES -- UNSAVE COMMAND 


BASIC program files are stored or updated with the SAVE or REPLACE 
command, respectively. These files can then be restored by the APPEND, 
OLD, or RUN command or the CHAIN or OVERLAY statement. These commands 


and statements are described in the BASIC-1l Language Reference Manual. 


Files containing BASIC programs can be deleted_by the UNSAVE command. 


The form of the command is: 
UNSAVE file descriptor 


where 


file descriptor is described in section 2.2. 


A file can be deleted only by a user who has complete access to it 
RR erreur yecretanceerrennneceeeae nae = 


(see section 2.3). 
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Examples: 
These examples assume the current user ID is GR. 


UNSAVE TEST Deletes the file TEST.BGR from the system 
device. 


UNSAVE FILE2.DGR Deletes the data file FILE2.DGR from the 


system device. 


2.5.1 Sequential Data Files 


Sequential files are treated in a manner similar to terminal input/ 
output; however, sequential file data can be manipulated in larger 
amounts and much more guickly than the equivalent terminal data. 
Data in sequential files must be accessed serially -- to get to the 
last data item in a sequential file it is necessary to read the en- 
tire file. 


nr amaan 1 
t associates a phys 


Da 
descriptor, with an internal locical unit number (also called channel 
number). A sequential file can be opened for output or input, not 
for both., To update an existing sequential file, it is necessary to 
open it for input and open a new file for output. Then all of the 


data must be read from the input file and written, including the up- 


The ,PRINT #expr statement outputs data to a sequential file opened 
for output. The expression after the number sign (#) must have the 
same value as the logical unit number of the file specified in the 
OPEN statement. The data stored in the file is the same data that 
would be printed on the terminal by an equivalent PRINT statement -- 


this includes space, carriage return, and line feed data. 


The JNPUT #expr, statement reads data from a sequential file opened 
_— need 


for input. The value of the expression following # must be the same 


as the logical unit number specified in the OPEN statement. Data is 
read from the £3 in the same way that it is input from the terminal. 


2 


The INPUT #expr statement reads an entire line of data (up to a car- 


riage return). If only one variable is specified in the INPUT # 
statement one data item is read from the file data line -- any excess 
data is ignored. If more than one variable is specified, BASIC reads 


gr Ll 
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as many data items from the line as needed. If there is insufficient 
data, BASIC reads the next data line from the file to get more data. 
If there is more than one numeric data item on a data line, they must 
be separated by commas -- spaces alone can not be used to separate 


data items. 


String data is always read to the end of the line so there can only be 


one string data item on a data line. 


NOTE 


When creating a sequential file that is 

to be read later by the INPUT #expr 
statement, it is necessary to insert the 
separators required. Commas and carriage 
returns are valid separators. If there 

is more than one numeric data item on a 
file data line, the INPUT #expr must speci-~ 
fy a number of variables equal to the num- 
ber of data items. For example, the data 
written by: 


OPEN "DATA" FOR OUTPUT AS FILE #1 
PRINT hy Sy get eng 1g 
CLOSE 


would be correctly read by: 


OPEN "DATA" FOR INPUT AS FILE #2 
INPUT #2, A, B 
CLOSE 


Commas must be printed as strings (as in 
the above example) but carriage returns 
are output by BASIC after every PRINT 
#expr statement (unless the list is ter- 
minated by a comma or semicolon). 


Once a data file has been opened for input, the end-of-file condition 
can be tested by the, IF END #expr_ statementy An input file can be re- 
stored to the beginning (the first data item in the file is read next) 
by the ,RESTORE #expr statement. 


Output files are made permanent when they are closed. , Files are closed 
by the execution of the CLOSE, CHAIN, or statement or the execution 
of the physical end of program (the highest numbered program line). 
Files are not closed when program execution is terminated by execution 
of a CTRL/C key command or STOP statement or the occurrence of a fatal 


program error. 
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,An_ output file which has been opened but not yet closed is purged by 


the execution of the SCR, BYE, RUN, OLD, or NEW command., If an out- 
put file is purged, all data output to the file is lost and the cur- 


rent contents of the file buffer are discarded. 


Sequential files opened for input can be closed or purged. The data 
stored in the file is unaffected. 


NOTE 


The contents of a file buffer are not ac- 
tually output to the device until the buf- 
fer is filled or the file is closed. For 
example, all output to the line printer 

is not completed until the file is closed. 


The PRINT #, INPUT #, IF END #, RESTORE #, CLOSE, and OPEN statements 
are described in the BASIC-11l Language Reference Manual. Some addi- 


tional features of the OPEN statement are described in this section. 


The format of the OPEN statement for sequential files is: 


OPEN string| "OR INPUT | a5 FILE[#]exprl [DOUBLE BUF] [,FILESIZE expr2j[,RECORDSIZE expr3][,MODE expr4} 
ae FOR OUTPUT : 


string is a file descriptor as described in section 
2.2. It can be any string expression. 


FOR INPUT specifies that an existing file is opened for 
input. FOR INPUT is assumed if neither FOR 
INPUT nor FOR OUTPUT is specified. 


FOR OUTPUT specifies that a new file is created. Any 
existing file with the same file descriptor 
will be deleted when the new file is closed. 


# is optional. 


exprl is the logical unit number, an integer in the 
range 1-127. Other statements access the file 
by specifying the logical unit number associ- 
ated with it. The logical unit number is also 
known as the channel number. 


DOUBLE BUF specifies that a second I/O buffer is allo- 
cated to the file if there is room in memory. 


,FILESIZE expr2 determines the area allocated for an output 
file on disk or DECtape. It is ignored on 
other devices and for input files. 
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,RECORDSIZE expr3 determines the buffer size for nonfile- 
structured devices or specifies a system 
buffer and channel (the latter is only 
available to privileged users). 


,MODE expr4 specifies special handling of magtape or 
cassette file. See section 2.5.1.1. Any 
specified MODE is ignored for other devices. 


The FILESIZE option specifies the maximum number of 256-word blocks 
that the file can occupy. If FILESIZE is not specified, then a 
default maximum file size is provided by the system manager. The 

?IFL (Illegal File Length) error message is printed if a nonprivileged 
user specifies a FILESIZE less than or equal to zero or greater than 


the maximum size allowed by the system manager. 


For a privileged user a FILESIZE @ gives the standard RT-11 file size 
allocation (which is either the larger of the second largest free area 
or half of the largest free area), a FILESIZE -l gives the absolute 
largest free area, and a FILESIZE of less than -1 causes the ?IFL 


error message. 


When a file is closed, the size of the file is reduced to the number 
of blocks that have actually been used. If output is attempted past 
the file size allocated, the ?FTS (File Too Short) error message is 
produced and all data is lost. 


When calculating the number of blocks to allocate to a sequential 
file, the following facts should be considered: there are 512 char- 
acters per block, spaces are valid characters, and each line output 
has two characters (carriage return and line feed) added to it. Once 


a file has been created it can not be extended. 


The RECORDSIZE option can be used to specify the buffer size for a 
nonfile-structured device. The buffer size is specified in bytes 
(two bytes equal one word of memory). Output speed can be increased 
by specifying a buffer size larger than the default. The standard 
default buffer sizes are given in Appendix D. The ?IRS (Illegal 
Record Size) error message is produced when a nonprivileged user 


specifies a buffer size less than l. 


The RECORDSIZE option can be used by a privileged user to request a 
system buffer and channel. If a RECORDSIZE -1 is specified and no 


area is available for a buffer in either the system I/O area (a buffer 
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area common to all users) or the user area, the file uses a system 
buffer. If no system buffer is currently available, the program waits 
for one to become free. A RECORDSIZE -1 also causes a system channel 
to be used if no user channel is available. If no system channe 
available, the program waits for one. The effect of a RECORDSIZE -1 
is that the OPEN statement never fails because, if the channel pool 
is empty or because no memory is available for a buffer, BASIC waits 
for a system channel and/or buffer instead of issuing a fatal error 
message. If a privileged user specifies a RECORDSIZE of 0 or less 
than -l the ?IRS error message is printed. 


NOTE 


If neither filename nor extension is speci- 
fied in the file descriptor a ?FPV (File 
Protection Violation) error message is pro- 
duced for nonprivileged users; but, for 
privileged users, the device is opened in 

a nonfile-structured manner. This can hap- 
pen if a string variable specifying the file 
descriptor is null. See section 2.5.1.2. 


Example: 


This example program creates a data file, closes the file, reads it 


back, and prints the sum on the line printer. 


10 REM FPROGRAM DEMONSTRATING THE OPEN STATEMENT 
20 OFEN "DATA" FOR QUTFUT AS FILE #1 
fo REM CREATES OUTFUT FILE 

3G FOR T#1 TO 100 

40 FRINT tists "s"sr™2 

20 REM THIS PRINTS T AND I-SQUARET 

6G REM TO THE, -P Le 

70 REM NOTE THE STRING CONSTANT "ys" 
BO NEAT I 

100 CLOSE 1 

110 OREN "DATA" FOR TNFUY AS FILE a2 
120 TF END #2 THEN 200 

130 INPUT #2+T9T2 

140 GeStI \ Ga=S2+12 

150 GO TO 129 

200 CLOSE 2 

210 OPEN "LP?" FOR QUTFUT AS FILE #1 
eeQ PRINT #12"THE SUM OF THE NUMBERS" > 
230 PRINT #129" 1 THROUGH LOO fS"es 

240 PRINT #i9"THE SUM OF THETR SQUARES IS "ese 
200 CLOSE 
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2.5.1.1 Sequential Files on Magtape and Cassette - BASIC operations 


involving cassette and magtape devices are handled somewhat differ- 
ently from those involving other devices, because of the sequential 
nature of cassette and magtape. It is possible to have only one file 
open at a time on any given cassette or magtape unit. If an attempt 
is made to open a file on a unit which already has a file open on it, 
the ?NER (Not Enough Room) error message is produced. 


The last file on a cassette or magtape is specially formatted. It 
marks the end of the existing data and is where new output normally 
begins. After a new file is created on the device a new specially 
formatted file is written after it. This file marks the new logical 
end-of-tape. This specially formatted file is called a double end- 


of-file on magtape and the sentinel file on cassette. 


When a file is opened, the device (CT or MT) is first rewound and then 
the tape is read until the file specified in the file descriptor is 
found or the logical end-of-tape is reached. If the file is opened 
for input, the operation is finished if the file is found, or the ?FNF 
(File Not Found) error message is produced if the file is not found. 
If the file is opened for output and the file specified is found, a 
special empty file descriptor is written there (the old file is de- 
leted) and then the tape is read until the logical end-of-tape is 
found. In any case, once the logical end-of-tape is reached a file 
header is written and the operation is completed. This search proce- 
dure is employed because there is no inclusive directory at the begin- 
ning of the tape and the only way to access a file is to search the 


tape from the beginning until the file is found. 


NOTE 


An existing file on a cassette or magtape 
is deleted when a new output file with the 
same filename and extension is opened on 
the device, not when the file is made per- 
manent. 


In conditions when files on disk or DECtape are normally purged (see 
section 2.5.1), files on cassette or magtape are closed. This is done 
because it is not possible to create new files on a cassette or mag- 
tape if the last output file was not closed. If the tape is physi- 
cally removed from the drive before the CLOSE operation, there is no 
logical end-of-tape and it is not possible to create new files on the 
tape. The MODE option or the RT-11l PIP program (see your system 


Manager) can be used to put a new logical end-of-tape on the device. 
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When a file on cassette or magtape is deleted a special file header 

is written to signify that the file is empty. When files are only 
written after the logical end-of-tape (the normal method of operation), 
the space freed by the file deletion is not reused. Two methods are 
available to reuse the empty space. One is to use RT-l1l PIP to copy 
the entire tape and then zero the old tape. The other method is to 
copy all the files after the empty file to a new tape and then use 


the mode option to create a logical end-of-tape before the empty file. 


MU BASIC/RT-11 does not support multiple volume files on cassette or 
mMagtape. If the physical end-of-tape is reached while BASIC is writ- 
ing a file, the ?DHE (Device Hardware Error) error message is produced 
and the operation is terminated without being completed. The portion 
of the file that has been written as well as all the other files on 
the device can be read but no new files can be created on the device. 
When reading the last block written on the tape BASIC prints a ?DHE 

or an ?00D (Out Of Data) error message, depending on whether the last 


block was incomplete. 


The MODE option in the OPEN statement allows files to be specified by 
position as well as by the filename and extension. The MODE option 
can be used when it is not necessary or desirable to rewind the tape 
before each operation or when the file to be accessed is known to be 
in a certain position. The MODE option also allows new output to 
begin before the logical end-of-tape (or when there is no logical 


end-of-tape). 


In an OPEN FOR INPUT statement, the MODE option limits the number of 
files to be searched and, if the file specified by the file descriptor 
is not found during the search, causes the last file in the search to 
be opened for input. If a positive expression is specified after 
MODE, the tape is not rewound and the search is limited to the in- 
teger value of the expression. For example, if the present position 
is after the 5th file on the tape and a MODE 3 is specified, the file 
specified by the file descriptor is opened if it is the 6th, 7th, or 
8th file on the tape - otherwise the 8th file on the tape is opened. 
A negative value for the expression following MODE has the same 
effect except that a rewind operation is done on the tape and then 
the absolute value of the expression is used to limit the search. 

For example, a MODE -5 causes the file specified by the file descrip- 
tor to be opened if it is the lst, 2nd, 3rd, 4th, or 5th file on the 
tape - otherwise it causes the 5th file to be opened. If the logical 
end-of-tape is reached before the specified number of files have been 


searched, the ?FNF (File Not Found) error message is produced. 
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NOTE 


The use of MODE in the OPEN FOR INPUT statement is 

not restricted by the BASIC file protection system. 
Any file can be accessed by position including files 
that have been deleted and files with extensions 
different from the current user ID. To assure privacy 
of data on cassettes or magtapes, access to the tape 
must be restricted and the cassette or magtape unit 
assigned by the ASSIGN command (see Section 3.1) 
before the tape is mounted. 


The MODE option in an OPEN FOR OUTPUT statement causes output to 
begin at the position specified by MODE. If MODE is followed by a 
positive expression, no rewind opération is done and output starts 

at the file position specified by the integer value of the expression. 
For example, if the present position on the tape is after the 3rd 
file, a MODE2 causes the new file to be created as the 5th file. All 
existing files after the fourth file are lost. If a MODE is followed 
by a negative expression, a rewind operation is done and output 
starts the position specified by the absolute value of the expression. 
If the logical end-of-tape is reached before the specified file 


position has been reached, output begins at the logical end-of-tape. 


All empty as well as active files on cassette and magtape are counted. 
RT-11l PIP can be used to create a magtape or cassette directory that 
lists all active and empty files. Magtape sometimes have an empty 

file inserted by the system at the beginning of the magtape. See 

your system manager or the RT-1ll System Reference Manual (DEC-11-ORUGA- 


B-D) for more information on PIP and magtape and cassette handling. 


Care must be employed when using the MODE option in an OPEN FOR 
OUTPUT statement. One reason is that if the rewind operation is 
inhibited (by a positive value of the expression) any file with the 
same filename and extension before the current position is not 
deleted. In this case, two files exist on the same device with the 
same filename and extension. In a subsequent OPEN FOR INPUT state- 
ment only the first file is seen unless the MODE option is used and 
the search begins after the first file. A second danger involving 
use of the MODE option in an OPEN FOR OUTPUT statement is that all 
files after the output file are lost. No check of file protection 
is made on these files; consequently, to prevent the loss of informa- 
tion stored on cassette, the cassette must be WRITE-PROTECTED (by 
uncovering the hole on the cassette) or access to the cassette must 


be restricted. 
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NOTE 


All files on cassette are written in 
groups of four 64-word blocks. The 
file header and sentinel file are 
written in special 32-word blocks. 


2.5.1.2 Nonfile-Structured OPEN Statement - A privileged user can 
open a disk, DECtape, cassette, or magtape in a nonfile-structured 
manner by not specifying the filename and extension. A disk or DEC- 
tape can be opened as either a sequential file or a virtual file (see 
section 2.5.2). In both cases the entire device is treated as though 
it were a normal BASIC file. To preserve the integrity of the system, 
public devices (see section 3.1) cannot be opened for output in a 
nonfile-structured manner, even by a privileged user. Nonpublic de- 
vices can be opened for output but this should not be done to a device 
that contains any RT-1l files to be preserved because any existing 
files will be lost. 


Care must be employed when opening a cassette in a nonfile- 
structured manner. Only a cassette that has been written in a 
nonfile-structured manner can be read in a nonfile-structured manner. 
Normal RT-11 cassettes can not be read in a nonfile-structured man- 
ner and cassettes created in a nonfile-structured manner cannot be 


read in a normal file-structured manner. 


In general, devices opened for output in a nonfile-structured manner 
will be nonstandard and will not be readable by all RT-11l system pro- 
grams and should only be used if the maximum data storage capability 


of a medium is necessary. 


2.5.2 Virtual Array Files 


Virtual array files are special random-access binary files. There 
are three data types for virtual array files: integer, floating 


point, and string. A file can only contain one data type. 
Virtual array files have several advantages over sequential files: 


They can be accessed in a random, nonsequential 
IManner. The last element of a virtual array file 
can be accessed as quickly as any other element 


whereas it is necessary to read an entire sequen- 
tial file before accessing the last element. 
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Data conversions are not required because numbers 
are stored in binary; consequently there is no 
loss of accuracy in writing a number out to a vir- 
tual file and then reading it back. The data con- 
version required by sequential files causes some 
loss of precision. 


Virtual array files are the only BASIC files that 
can be updated without copying the entire file. 


Virtual array files are treated like normal arrays stored in memory 
with the following differences: 


Virtual array files allow the processing of much 
larger arrays than could fit in available memory. 


They also allow data to be saved from one execu- 
tion of a program to another. 


Elements of a virtual array file are not initial- 
ized to zero when a program is run. 


Integer virtual files are restricted to integer 
values; no similar restriction applies to any ar- 
ray in memory. 


Strings in virtual files have a fixed maximum 
length which is determined when the file is opened; 
elements of string arrays in memory can be any 
length (up to 255 characters). Elements of string 
virtual arrays that are shorter than the maximum 
length have null characters appended to them until 
they are the maximum size. When an element is re- 
trieved it is stripped of its trailing null char- 
acters. 


Elements of a virtual array file can be assigned 
values only by a special form of the LET state- 
ment while elements of normal arrays can be as- 
Signed values by the LET, READ, INPUT, or CALL 
statements. 


Virtual arrays can only have a single subscript 


(dimension); arrays in memory can have one or two 
dimensions. 


The special form of the OPEN statement for virtual files is: 


C “7 
OPEN string [FOR aa AS FILE VF int [2] [(exprl)] [=expr2][,FILESIZE expr3] 
+ 
where: 
string is a file descriptor as described in sec- 
tion 2.2 and can be any string expression. 
FOR INPUT an existing virtual array file is opened. 


Both output and input are allowed. If neither 
FOR INPUT nor FOR OUTPUT is specified, FOR 
INPUT is assumed. 


2=20 


FOR OUTPUT 


int 


oo 


exprl 


=expr2 


FILESIZE expr3 
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specifies the creation of a new virtual array 
file. Any previous file with the same file 
descriptor is deleted when the new file is 
closed. Both output and input are allowed. 


is the virtual array logical unit number, an 
integer in the range 1 to 127. Elements of 
the array are accessed by specifying this 
virtual array logical unit number. This 
logical unit number is completely independent 
from sequential file logical unit numbers. 


indicates an integer virtual array file. 
indicates a string virtual array file. 


When neither % nor $ is specified, the vir- 
tual array file is floating point. 


is the dimension of the file. It is the maxi- 
mum subscript that can be used in accessing 
the array. This is not true when FILESIZE is 
also specified. 


is the fixed maximum string length in the 
range 1 to 255. This should be specified only 
when $ is also specified. Default value is 32. 


has the same meaning as in the normai OPEN 
statement (see section 2.5.1). The maximum 
legal subscript is determined by the number 
of elements that can fit in the file. When 
FILESIZE is specified it supersedes the di- 
mension specified in expr2. 


NOTE. 


When a virtual file is first created, 
FOR OUTPUT must be specified but to up- 
date the data in the file FOR OUTPUT 
must not be specified. One consequence 
of this is that the program to create a 
new virtual file must be changed to up- 
date the file. 


The actual size of the permanent virtual file is determined only by 
the OPEN FOR OUTPUT statement that created it. When the file is 


closed the file size is not reduced. Nor can the file be extended 


once it has been opened. 


The only way to extend a virtual array is 


to open a new, larger virtual array file and then copy all the data 
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To save the data in a virtual file, the file must be made permanent 
(closed). Virtual files are made permanent or purged (lost) under 


the same conditions as sequential files (see section 2.5.1). 


Once a virtual array file has been opened its elements can be used 
the same as any other variables in a BASIC program with one exception: 
an element of a virtual array can only have a value assigned by a 
special form of the LET statement: 


[LET] VF integer (exprl)=expr2 


where: 
integer must be an integer constant (not an expression) 
and specifies the virtual array logical unit 
number. 
exprl specifies the element in the array. 
expr 2 must be the same data type as the array. 


If an integer virtual file element is assigned a value greater than 
32767 or less than -32768, the ?IDT (Illegal Data Type) error message 
is produced. 


Table 2-2 describes the number of elements of each data type that can 
be stored in one 256-word (512-byte) block. 


Table 2-2 
Storage Requirements of Virtual Arrays 


Bytes per Elements per 
Data Type Element Block 


Floating point 4 128 


Integer (3%) 2 256 


String (S$) string length 512/string length 


String ($) - default 
length 32 16 


The number of string elements per block can be fractional. 


NOTE 


DECtape. 
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Examples: 
The following examples assume the current user ID is B9. 


OPEN "TEST" AS FILE VF1S (2000) = 10 


Opens the existing file SY:TEST.DB9 as virtual array 
file 1 containing 2001 string elements; each one 10 
characters long. This file is now available for 


oe a | 3 rid 
input and output operations. A reference to file 


element 2001 or greater causes an error. 
OPEN "TEST2" FOR OUTPUT AS FILE VF2S (500) 
Creates a new file SY:TEST2.DB9 as virtual array file 


2 with 501 string elements, each 32 characters long. 


OPEN "TEST3" FOR INPUT AS FILE VF3 


Opens the existing file SY:TEST3.DB9 as virtual array 
file 3. It consists of floating point numbers because 
neither $ nor % is specified. Both input and output 
operations are legal. 


tmnmama it 


T AS="TEST4 
EN AS FOR OUTPUT AS FILE VF43 (50),FILESIZE (10) 


Creates the file SY:TEST4.DB9 and opens it for input 
or output as virtual array file 4 with 10 blocks. The 


FILESIZE specified overrides the dimension (50); conse- 
quently, elements 0 to 2559 can be accessed. 


These files can then be used in BASIC operations as follows: 


LET A = B + VF3(I)/2 


Uses the value of virtual array file element VF3(I) in 
computing an expression. 


PRINT "VARIABLE" ,N,VF4(N) 


Uses the value of integer virtual array file element 
VF4(N) in a print list. 


LET VF3(2*N+1) = (A + B)/2 


Sets the value of virtual array file element VF3 (2*N+1) 
c 
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LET VF1(101) = "ABCD" 


Sets the value of string virtual memory file element 
VF1(101) to "ABCD" followed by six null characters. 
When VFl (101) is evaluated the trailing nulls will 
be automatically deleted. 


Any virtual file opened should be closed by the CLOSE statement. 


CLOSE [VF integerl [,VFinteger2,VFinteger3,...]] 


Examples: 


CLOSE VF3 closes virtual file 3 
CLOSE closes all files including virtual files 
NOTE 


There may be problems when two users attempt 
to simultaneously assign values to elements 
of the same virtual array file. See section 
2.504. 


Example: 


my 


FRINT "“OCTAL DUMP" \ REM THIS PROGRAM PRINTS AN OCTAL 
PRINT "FILE NAME"; % REM CUMF GF THE SPECIFIED FILE 
INPUT FS 

PRINT "START BLOCK, #BLOCKS"; 

INFUT B4, 62 

OPEN FS FOR INPUT AS FILE ¥Fik 

OPEN “LE: " FOR GUTPLUT AS FILE #2 

PRINT #2: "O0CTRL GUMP OF FILE "i FE 

FOR B=B1 TO Bi+be-4 


wed PR bee 


aT A Ae 


ee wn) 


ae 
ta! 


fon Re om oa 


es Oe OS On (ee SS ce SO 
ts 
Pacey a BON We Deon] 


26 PRINT #41 

4H FRINT #41 ° "“ELOCK"; & 

256 FOR L=@ Toh oct’ zF’ 

268 LET velLe#de 
2° GOSUB 1toGa 

BSH PRINT #1: SEGECYS, 4, ar aie 

e78 FOR f= To ? 

2H LET VE¥Fithe25e6+Lesest 

S18 GOSUE 1898 

oe PRINT: Bye args 
ZE8 NEXT 5 

S48 FRINT #1 

S58 NEXT L 
S6G PRINT #41 

2°68 NERT & 

S86 CLOSE #4 

39 STOP 

1hoe LET Wasyvo% REM THIS SUBROUTINE CONVERTS 
1485 FEM INTEGER \ 

1418 LET Weo"" %\ REM TO ASCOT STRING YS, WHICH 
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4928 LET Vis’ @° \ REM Ié THE OCTAL ¥YALUE OF ¥ 
4428 IF Ws THEN 1868 %\ FEM USES V1. Ne. YE. VLE. YEF 
1646 LET VWa=¥it2e "15 \ REM Y IS PRESERVED 

4956 LET ¥is="1" 

1466 FOR T=i TO 5 

A987 LET VWESINTcy¥ai-S> 

1656 LET VWeS=STRSCV1-VERSD 

1696 LET WeaVetays 

1449 LET ¥Yis¥s 

4244 NEXT I 

120 LET YSHVLSevs 

iit@ RETURN 


For more information on virtual files see Appendix C. 
2.5.3 File Deletion and Renaming 


The NAME TO statement changes the name of a file on disk or DECtape; 


it does not alter the contents of the file. The form of the NAME TO 
statement is: 


NAME stringl TO string2 


where: 
stringl is a file descriptor as described in section 2.2 
that specifies the file to be renamed. 
string2 is a file descriptor that specifies the new name 


and extension. No device should be specified. 
BASIC programs can be renamed by the NAME TO statement by explicitly 
specifying the extension. A NAME TO is illegal on cassette and mag- 


tape and is ignored on devices which do not support named files. 


Examples: 


These examples assume the current user ID is B9. 


NAME "DATA" TO "“OLDDAT" Changes file SY:DATA.DB9 to 
SY:OLDDAT.DB9. 

NAME "@PROG.B" TO "@PROG2.B" Changes file SY:PROG.BB9 to 
SY:PROG2.BB9. 

FS="PROG" Changes file S¥:PROG.BBS to 

NAME "@"4+FS+".B" TO "@"+FS+".A" SY:PROG.AB9. 
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pthe KILL statement deletes a fileg It is similar in effect to the 


UNSAVE command except that,KILL assumes a data file., The form of 


the KILL statement is: TS ga eee ara 
KILL string 
where: 
string is a file descriptor as described in section 2.2. 
Examples: 


These examples assume the current user ID is BS. 


KILL "FILE1L" Deletes the file SY:FILE1.DBS. 


KILL "PROG.BBS" Deletes the file SY:PROG.BBS. 


2.5.4 Simultaneous File Updating Restrictions 


BASIC does not place any restriction on more than one user opening 
the same file. A user can be prohibited access to a file by the 

file protection system, but there is no mechanism to restrict access 
to a file only when another user has opened it. There is no conflict 
when only one user is writing to a file and all other users are 


reading it. There are two conditions in which conflict occurs: 


Two or more users have opened a file for output with the 
same filename and extension (on the same device). 


Two or more users are updating an existing virtual array 
file. 


If two or more files are opened on a device with the same filename 

and extension, only the last file closed remains permanent. Ordinarily 
this problem should not occur since nonprivileged users do not have 

the ability to create files with extensions whose second and third 
characters are different from the user ID. It could occur if two or 
more users have logged into BASIC with the same user ID; consequently, 
this practice is not recommended. Privileged users do have the ability 
to creaté files with any extension and should take care that they do 
not create files with the same extension used by a nonprivileged user. 


The same restriction applies to replacing BASIC programs. 
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The virtual file facility provides a means for maintaining a data base. 
This data base can be read by more than one user simultaneously. It 

is important to note that BASIC does not provide any record-locking 
facility. If two users attempt to write values into the same record, 
the user who accesses another record (or closes the file) last has 


the values written. The values written by all other users are lost. 
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CHAPTER 3 


SYSTEM COMMANDS AND FUNCTIONS 


3.1 ASSIGNING DEVICES 


BASIC ensures that each user can independently access devices. Some 
devices, disk and DECtape units, can be accessed safely by more than 
one user simultaneously. These devices are called public devices. 
Other devices, cassette, magtape, card reader, high-speed paper tape 
punch, high-speed paper tape reader, and line printer, can be accessed 
by only one user at a time. These are called nonpublic or assignable 
devices. In addition, the system manager can designate any disk or 


DECtape unit as nonpublic. 


NOTE 


Each separate unit of a device is con- 
sidered unigue, for example, CT@: (Cas- 
sette unit @) and CTl: (Cassette unit 1) 
are considered separate devices. 


Only one user can access a nonpublic device at any one time. The de- 
vice becomes available to other users only when the user currently 
accessing the device releases it. There are two ways to obtain access 


to a device: 


1) By means of the ASSIGN command. 


2) By means of a file-related command or statement. 


When a user enters an ASSIGN command for an available device, BASIC as- 
Signs the device to that user. No other user can access the device 
until the user who has obtained assignment enters a DEASSIGN or BYE 


command to deassign the device. When a user enters an ASSIGN command 
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for a public or unavailable device, the ?DNA (Device Not Available) 


error message is produced. 


If a user accesses an unassigned device by means of a file-related 
statement or command, the device is made unavailable to other users 


until the operation is completed. 


File-related statements and commands are the OPEN, KILL, NAME TO, 
OVERLAY, and CHAIN statements and the SAVE, UNSAVE, OLD, APPEND, and 
RUN file descriptor commands. (For all statements and commands except 
the OPEN statement the device is unavailable until the operation is 
finished.) After the execution of an OPEN statement the device is un- 
available to other users until all the user's open files on that de- 


vice are closed. 


Figure 3-l illustrates the possible states for a nonpublic device. 


ASSIGN OPEN 
DEASSIGN a 


IN USE 
BYE 
CLOSE ey, 
OPEN DEASSIGN 
ASSIGNED 


AND 
IN USE 
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ASSIGNED signifies exclusive use and IN USE signifies temporary use. 
Both conditions can exist concurrently for the same user. OPEN sig- 
nifies execution of the OPEN statement or the beginning of any 

other file related command or statement. CLOSE indicates the execu- 
tion of the CLOSE statement (or of any statement or command that 
closes files) or the completion of any file related command or state- 
ment (other than OPEN). A public device is always AVAILABLE, even 


when it is being used. 


Every file on a device must be closed before the device becomes avail- 
able. For example, if a user has not assigned a device but has opened 
two files on it, both files must be closed before the device becomes 


available to other users. 
The form of the command to assign a device is: 
ASSIGN device: 
where device: is one of the device symbols described in Table 2-l. If 
an attempt is made to ASSIGN a device that is already assigned to the 
same user the command is ignored and no error message is produced. 
The form of the command to deassign a device is: 
DEASSIGN [device:] 
where device: has the same meaning as in the ASSIGN command. 
If no device is specified in the DEASSIGN command, all devices as- 


signed to the user are deassigned. The BYE command also deassigns 


all devices. 


3.2 LENGTH COMMAND 


The LENGTH command displays on the terminal the amount of storage re- 

quired by the BASIC program in memory. This information is useful in 

determining the minimum user area in which a specific program can run. 
The system manager can use this information in determining the size of 
the user areas (see MU BASIC/RT-11 System Installation Notes). The 


form of the command is: 


LENGTH 
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The LENGTH command produces this message: 


mmm WORDS USED, nnn FREE 


where: 
mmm is the number of words currently occupied by the user's 
program 
nnn is the number of words remaining free in the user's area 


The number of words in use includes memory currently needed by the BASIC 
program itself, arrays, string variables, and file buffers in the user's 
area. To determine the size of the program alone, enter the LENGTH com- 
mand immediately after an OLD or CLEAR command. Arrays are created 
after the RUN command and file buffers are created when the OPEN state- 
ment is executed. The memory required for string variables and string 
arrays varies with the current values of the strings; consequently, the 
LENGTH command returns the current memory requirements, which may be 


smaller than the maximum memory requirements. 


Several error messages can be produced when the program exceeds the 
amount of memory available. These errors are ?ATL (Array Too Large), 
?BSO (Buffer Storage Overflow), ?PTB (Program Too Big), and ?SSO (String 


Storage Overflow). Program size can be reduced by several procedures: 


Eliminate or reduce unnecessary items such as REMark 
statements, long printed messages, and optional key- 
words such as LET. 


Make maximum use of multiple statement lines. 


Make efficient use of program loops, subroutines, 
user-defined functions, and computed GO TO state- 
ments. 


Split up large programs into several smaller pro- 
grams by use of CHAIN or OVERLAY statements. 


Reduce the size of arrays in memory to the size 
required (DIMension statement). 


Use virtual array files for arrays that are too 
large to fit into memory. 


Reduce the number of variables and arrays in a pro- 
gram by reusing them when their contents are no 
longer needed, instead of creating new variables or 
arrays. 
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Reduce the number of simultaneously open files by 
opening a file just before it is needed and clos- 
ing it immediately after the last uSe. 


After program lines are deleted, the programcan be stored by the SAVE 
command and restored by the OLD command to further optimize program 


memory requirements. 


File buffers are stored in a system I/O area common to all users if 
there is no room in the user area. If there is no room in either the 
user's area or the system I/O area, a ?BSO (Buffer Storage Overflow) 
error message is printed, except when a privileged user has specified 
the RECORDSIZE -1 option in the OPEN statement. See section 2.5.1 for 
a description of the RECORDSIZE option. 


For more information on program storage see Appendix D. 
3.3 TERMINAL CHARACTERISTICS 


Many different terminals can be used with BASIC. Several system func- 
tions and commands allow use of specific characteristics of the termi- 
nals. The SET TTY command specifies the class of terminal; system 
function 6 sets the width of the terminal; CTRL/S and CTRL/Q key com- 
mands stop and then restart output to the terminal, the TAPE and KEY 
commands, and system functions 1, 2, and 3 facilitate the use of the 
low-speed paper tape reader on the ASR33 terminal. The system func- 


tions are described in section 3.4. 


BASIC has a type-ahead feature which allows terminal input to be 


entered before BASIC is actually ready to process it. For example: 


WW 
! 
4 
7 
Sad 
! 
Lacs 
rT 


= 
1 
—¥ 
a 
pt 
a 
J 
Tt 
a. 
AE 
i 
mm 
BS 
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’ 
Vi 
i} 
t— 
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While the paper tape is being read the LIST and RUN commands and the 
data 4 have been entered. The first READY indicates that the OLD com- 
mand has finished. The program is then listed and run. The question 
mark is produced by the INPUT statement; however, because the data has 
already been entered BASIC prints the values on the same line as the 


question mark. 


If the CTRL/C key command is typed at any time, however, it is seen 
first and any unprocessed type-ahead is discarded. 


If type-ahead exceeds thirty characters, the next character is accepted 
but is not echoed until the type-ahead is processed. If still more 
characters are entered BASIC rings the terminal bell to indicate that 


no more characters can be accepted. 


NOTE 


Extreme care should be used with the type- 
ahead feature. The printing on the termi- 
nal may become difficult to read. This 
does not affect the processing of the type- 
ahead. 


3.3.1 Stopping Output to Terminal 


The CTRL/S key command (may be labeled XOFF on some terminals) temporar- 
ily suspends all output to the terminal. This allows an alphanumeric 
display terminal (vT05, vT50, etc.) to be photographed, copied or read 
without the information on the screen being lost. The CTRL/S key com- 
mand itself does not cause any character to be printed on the screen 


(it is not echoed). 


The CTRL/Q key command (may be labeled XON on some terminals) causes 
output to the terminal to resume. The CTRL/Q command itself does not 
cause any character to be printed (it is not echoed). No characters 
are lost in a CTRL/S - CTRL/Q combination. In addition to its normal 
functions, the CTRL/C command also causes output to the terminal to 
resume after a CTRL/S command. 


NOTE 


While both the CTRL/O and CTRL/S key com- 
mands stop output to the terminal, they 

are not equivalent. The CTRL/O key com- 
mand causes all output to the terminal to 
be lost - the program continues executing 
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but does not print anything on the termi- 
nal. The CTRL/S command stops output to 
the terminal and program execution. When 
program execution -is resumed (by the CTRL/ 
Q command) output resumes. No program 
output is lost during this CTRL/S and 
CTRL/Q combination. 


3.3.2 Using the Low-Speed Paper Tape Reader/Punch 


BASIC usually prints on the terminal's printer every character input 
by the low-speed paper tape reader or the keyboard. This process, 
called "echoing", provides a visual confirmation of what has been 
typed; however, when reading tapes from the low-speed reader echoing 
is often undesirable, because tapes often contain data that is fre- 


quently reused. 
The TAPE command stops the echoing process. It also causes the RUB- 
OUT key command to be ignored. This allows paper tapes to be input 
on the low-speed reader without printing the contents of the tape on 
the terminal. When creating a papertape to be input using the TAPE 
command, an erroneous character should be deleted by physically back- 
spacing the tape and then typing the RUBOUT key. 
The form of the command is: 

TAPE 


The TAPE command has the same effect as the system function l. 


After the TAPE command has been executed the echoing process may be 
resumed by typing the KEY command. 


The form of the KEY command is: 
KEY 


If the TAPE command has been executed the KEY command itself is not 


echoed but all following characters typed at the terminal are echoed. 
The KEY command also causes RUBOUT to have its usual effect. 


Echoing is also resumed after a CTRL/C key command or the execution 


of system function 2. 
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NOTE 


When creating binary tapes or tapes of 
BASIC programs (whose lines are longer 
than the terminal width) on the low-speed 
paper tape punch use the SYS(6,0) system 
function to prevent automatic printing of 
carriage return/line feed combinations. 
During its normal operation, BASIC occa- 
sionally outputs a null character to the 
low-speed punch. This is ignored when 
BASIC reads the tape. 


SET TTY Command 


The terminal type for all local terminals should be set by the system 


manager when the system is initialized; the SET TTY command should not 


be used on these terminals. 
terminal to be used, 
ters with the SET TTY command. 


However, to allow any type of dial-up 
a user can set the correct number of fill charac- 


In this respect, there are three 


classes of terminals: 


1. 


For 


is: 


For 


3 
(i) 
to 
a 
ct 
Ke 
ae) 
a 
E 


ASR33 
KSR33 
ASR35 
KSR35 
LA3§-P 
VTg5 


LA36 
VT5¢ 
LA3£-C 
LA3§-E 


VTP5 


SET T 


SET T 


isa 


Teletype’ with low-speed paper tape reader/punch 
Teletype 

Teletype with low-speed paper tape reader/punch 
Teletype 

Parallel DECwriter 


Alphanumeric display with a data rate less than or 
equal to 300 baud. 


DECwriter II 
Alphanumeric display 
Serial DECwriter 
Serial DECwriter 


Alphanumeric display with a data rate greater than 
300 baud. 


all terminals in the first class the appropriate SET TTY command 


TY ASR33 


serial LA39 DECwriters the appropriate command is: 


TY LA3¢ 


registered trademark of the Teletype Corporation. 
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For a VTf#5 alphanumeric display with a data rate greater than 300 baud, 


the appropriate command is: 


The SET TTY command has no effect on the terminal margin. See section 


3.4.5 for information on setting the terminal margin. 
3.4 SYSTEM FUNCTION CALLS 


System function calls perform a variety of operations. Certain system 
functions are available to all users. These cancel a CTRL/O typed at 
the user's terminal, disable echoing, reenable echoing, enter a special 
Single-character input mode, scratch the user's program in memory and 
then return to the READY message, and return the current user ID. Cer- 
tain other system function calls can be executed only by a privileged 
user. These disable the CTRL/C interrupt, set the user ID, terminate 
the privileged user status, and cause BASIC to exit and return control 
to the RT-11 monitor. 


The system functions can be used in any arithmetic expression, but for 
reasons of simplicity and compatibility it is recommended that system 
functions only be used in the LET statement. 


The format of the system function call in the LET statement is: 


[LET] var=SYS (exprl[{,expr2]) 


where 
var is the target variable. The value returned by 
the system function is stored in the target 
variable. 
exprl determines the system function to be performed. 
expr 2 is an optional argument used in some SYS func- 


tion calls. 


Table 3-1 describes the system functions that are performed when exprl 
is in the range -4 to +8. If the value of exprl is less than -4 or 
greater than 8 the ?ARG (Argument Error) message is printed. If expr2 


is specified and not expected the ?SYN error message is printed. 
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Table 3-1 
Summary of System Function Calls 


Value of exprl Function Executed by the SYS Call 


Cancel effect of CTRL/O typed on terminal. 


Enter special mode for inputting tapes on the low- 
speed reader. 


Enable echoing. Cancels effects of SYS(1) and 


SYS (3). 
3 Disables echoing. 
4 Single character input mode. Target variable con- 


tains the ASCII value of the next character typed 
at terminal. Optional argument, expr2, specifies 
logical unit number of file. 


5 Delete current program, change program name to 
NONAME, and print the READY message. 


7 Re-enable CTRL/C as an interrupt. 
8 Privileged function call; disable CTRL/C as an in- 


6 Set the terminal margin to the value of expr2. 
| 
terrupt. Causes BASIC to ignore any CTRL/C typed | 
at terminal. | 
| -1 Privileged function call; sets the user ID to the 
value specified by ASCII value in expr2. If expr2 
is negative return the current user ID as the value 
of the function. 


Clear privileged user status. User will not be 
able to execute any privileged functions or file 
operation. 


Privileged function call; return to RT-11 monitor. 
A SYS(-3) function call should be executed by a 


privileged user only if he has notified all other 
users that the system will be taken down and that 
they should terminate their jobs. 


Return privileged status (+1 for privileged or §g 
for nonprivileged). 


It is possible to combine two or more system function calls in one 
statement, for example, the statement: 


LET A = @*SYS(3) + SYS(4) + @*SYS(2) 


turns off echoing, inputs a character from the terminal, and turns 


echoing back on. The system functions are executed in order of the 


normal BASIC-11 
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3.4.1 System Function @§ - Disabling CTRL/O 


The CTRL/O key command stops output to the terminal; execution of the 


system function call @ causes output to resume. 
Example: 


In the following example, data is input from a file. Each value is 
printed on the terminal and then a sum is printed. A CTRL/O key com- 
mand typed any time before line 100 is executed suppresses printing 
of all further data items but does not suppress the printing of the 


final sum. 


S REM PROGRAM TO INFUT DATA 
? REM AND PRINT SUM 

16 OREN "PRI" FOR INPUT AS FILE #4 
2a PRINT "DATA IN FILE:" 

28 TF END #2 THEN 106 

a6 INPUT #4. 


Ha FROIN? O, 
= J 
I 


3.4.2 System Functions 1, 2, and 3 - Using the Low-Speed Paper Tape 
Reader/Punch 


BASIC usually echoes every character input by the low-speed reader or 


the keyboard. This provides visual confirmation of what has been 


Pa ot a 2 ee oe 
Ccérrcain caSésS. S 


. . 


typed; however, echoing is undesirabl 


e in 
tions 1 and 3 disable echoing. System function 2 enables echoing. 


System function 1 allows compatibility with paper tapes produced by 
other systems when they are read by the low-speed reader. System 
function 1 disables echoing and causes all RUBOUTs to be ignored. 
RUBOUT is the character normally used in BASIC to delete the previous 
character typed. Some other systems correct an error on paper tape by 
physically backing up the tape and then typing a RUBOUT to erase a 
character. System function 1 should only be used to read tapes pre- 
pared in this manner. System function 3 should be used for reading 
all other paper tapes on the low-speed reader. System function 2 
canceis the effect of system function 1 or 3. Echoing is resumed 


and RUBOUT resumes its usual meaning. 
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Example 


40 REM PROGRAM TO INPUT 
26 REM FROM THE LOM SPEED READER 
25 DIM Reiger 


EA 22575050 % REM OTSRELE ECHOING 
48 OF EN "KE: FOR GTNMPUT AE FILE #6 
45 FOR [=i To ie 
Be INPUT #6, Ago REM INPUT FROM RERDER 
Pa WEST I 
164 2Z=oYS¢20 \ REM RESUME ECHOING 
NOTE 


Turning off the echoing does not affect 
printing caused by PRINT statements and 
BASIC-11l messages. 


3.4.3 System Function 4 - Single-Character Input Mode 


System function 4 returns the decimal ASCII value of the next charac- 
ter input from the terminal or froma file. (See Appendix A for a 
list of the ASCII values.) System function 4 is the only method for 
BASIC programs to process terminal input without waiting for a car- 
riage return to be typed. This allows interactive programs to use 


Single character response and not require a carriage return. 
Any key or key combination on the terminal is a valid response to a 
system function 4 input request except CTRL/S or CTRL/Q. CTRL/C 


is only valid if the CTRL/C command is disabled. 


Example 


Ce PR EA Pale BEL Se He 
eH PESYSt4) *% REM SINGLE CHARACTER IAPUT 
ao PRINT 
TF ASASCe THY THEN 2h 
fh RT OF 
Ba PRINT “INFORMATION THAT YOU SHOULD ENOW" 


To input a single character from a sequential file, specify the logical 
unit number of the file as the second argument in the system function 

4 call. System function 4 then returns in the target variable the 
ASCII value of the next character in the file. All characters includ- 
ing nulls are returned. This allows data in any file to be read with 
no need for separating commas or carriage returns. Binary files can be 
copied exactly by use of system function 4. When the end of the file 
is reached system function 4 returns a value of -l. (Successive calls 
also return -1l.) 
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The file must be opened for input as a sequential file, not as a vir- 


e 


tual file. 


JOTE 


If a file is opened on the terminal (KB:) 
a system function 4 acting on the terminal 
file is the same as a system function 4 
with no file specified. CTRL/S and CTRL/Q 
are not valid responses on a terminal to a 
system function 4 input request. 


Example 


This example will copy any RT-1l file exactly. 


16 PRINT "INPUT FILE"; 

ef INPUT 1¢ 

26 PRINT “QUTPUT FILE"; 

46 INFUT O¢ 

o6 QPEN [¢ FOR INFUT AS FILE #24 
BH OPEN OF FOR OUTPUT AS FILE #2 
PA A=SYSe4, 15 

S68 IF A=-i THEN 288 

S96 PRINT #2, CHEE¢AS; 

168 GO TQ 7@ 

2Sae CLOSE 

216 GO TO 19 


This program is less efficient and slower than a copy program that uses 
string variables to copy files. But a copy program using string vari- 
ables does not copy some characters and requires that carriage returns 


separate strings. 
3.4.4 System Function 5 - Return to READY 
Execution of a SYS(5) system function call deletes the program in mem- 


ory, changes the program name to NONAME, and returns to READY. This is 
a useful method of terminating programs that are not to be rerun. 
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Example: 


EIST 
DELETE 47-MAR-75 MU BASIC/RT-11 Te1-Ge 


46 REM THIS PROGRAM HILL DELETE ITSELF 
26 A=SYS033 
READY 


RLUNNH 


READY 
LIST 


NONAME 47°-MAR-75 ML BASICART-1i rei-ae 


READY 


System function 5 is equivalent in effect to the SCR command. 


See the BASIC-11 Language Reference Manual for a description of the 
SCR command. 


3.4.5 System Function 6 —- Terminal Margin 


System function 6 sets the maximum number of characters that can be 
printed on one line. BASIC initially assumes a terminal margin of 72 
and outputs a carriage return/line feed combination after printing 72 
characters on a line. Execution of system function 6 with a nonzero 
second expression (between 1 and 255) causes BASIC to output a car- 
riage return/line feed after printing the number of characters speci- 
fied in the second expression. The margin also affects echoing - if 
more characters are entered than fit on a line, a carriage return/ 


line feed is printed and the excess characters are echoed on the next 
line. 


If a line is partially full and there is not enough room for an 

output string (or number), a carriage return/line feed combination 
is printed and the string (or number) is printed on the next line. 
An output string (or number) longer than a complete single line is 


continued on the next line. The process is repeated as many times as 
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necessary to print the entire string (or number). Even if a line is 
partially filled when a system function 6 is executed, the margin is 
changed for that line. 


NOTE 


BASIC outputs characters to a terminal buffer and 
continues program execution without waiting for 
the characters to actually be printed on the ter- 
minal. If a system function 6 changes the margin 
while there are characters in the buffer, a 
carriage return will be printed when the new 
margin is reached or exceeded. But BASIC tests 
if a string or number will fit on a partially 
filled line before outputting the characters to 
the buffer and this test is not affected by a 
later margin change. 


Example: 


10 A&SYS(6910) \ REM SETS MARGIN TO 16 
20 FRINT "1234567"59 "8901" 

30 PRINT "THIS LINE WON’T FIT!" 

RUNNH 

L2343567 

8901 

THIS LINE 

WON? T FET! 


REATIY 


With amargin of ten, the string "8901" does not fit on the first line 
of output, so it is printed on the second line. The string to be 
printed by line 120 will not fit on one line, so it is printed ten 


characters per line until the string is exhausted. 


A system function 6 with a second expression equal to zero suppresses 
printing of any automatic carriage return/line feed combinations. 
This suppression is useful when preparing binary tapes or tapes of 
BASIC programs (whose lines are longer than the terminal width) on 
the low-speed paper tape punch or when using special cursor control 
characters available on some alphanumeric video display terminals. 
(Cursor control characters determine where on the video display 


screen the next printed character will appear.) 


To set BASIC to use the full width of an LA36 DECwriter II (132 
columns) type: 


A = SYS (6,132) 
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To set BASIC to use the full width of a VT50 alphanumeric display 
terminal or LA30 (80 columns) type: 


A = SYS(6,80) 


To set BASIC to use the full width of a VTO5 or ASR33 (72 columns) 
type: 


A = SYS(6,72) 


This returns BASIC to the initial default state. 


3.4.6 System Functions 7 and 8 - CTRL/C Disable 


The system function call 8 is a privileged function call that causes 
the CTRL/C key command to be ignored. If a nonprivileged user at- 
tempts to execute SYS(8), the ?PSF (Privileged System Function) error 
message is produced. A program should be thoroughly debugged before 
the SYS(8) function call is inserted. 


The system function 7 can be executed by any user and it returns 
CTRL/C to its normal meaning. If CTRL/C is already enabled, a SYS(7) 
is ignored. 


NOTE 


If a program executes a SYS(8) function 
call and then enters a closed loop, it is 
not possible to halt the program. All 
other users are unaffected but it is not 
possible to use the terminal at which the 
error has occurred until the MU BASIC/ 
RT-11 system is taken down and then 
brought up again. 


3.4.7 System Function -l - Set User ID 

The SYS(-1, expr2) function sets the user ID to the letters specified 
by a positive ASCII value in expr2. This is a privileged system furc- 
tion call. To set the user ID to a value "AB" the following system 


function call could be executed: 


A = SYS(-1, ASC("A")+256*ASC("B") ) 
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Only the ASCII values of the characters A through Z and the digits 0 
through 9 should be used for the user ID. The second character, how- 
ever, can be a null. Use cf any other values results in illegal RT-11 


file descriptors. 


3 
ox 
(D 


If the value of expr2 is negative, the system function call ca 


executed by any user and it returns the current user ID. 


Example: 


164 ASS St-f.ei5 
2 US=CHRECAI+CHRE CASSIE SD 
BE PRINT "CURRENT USER If TS "; es 


3.4.8 System Function -2 - Clear Privileged Status 


A SYS(-2) function call clears the privileged status indicator for the 
current user. After execution of a SYS(-2) function it is impossible 
to execute a privileged system function or a privileged file operation. 
It is possible to regain the privileged status only by typing the BYE 
command and then logging on under a privileged user ID (see Chapter 1). 


3.4.9 System Function -3 - Return to RT-11 Monitor 


SYS(-3) is a privileged system function. It allows BASIC to be taken 
down to return control to the RT-1l monitor. SYS(-3) causes all users' 
programs to be terminated and erased and all files open for output to 
be deleted. After a SYS(-3) function call it is not possible to enter 
any commands or program lines to BASIC until BASIC is reloaded by the 
system manager. Consequently, all users should be notified, if pos- 


Sible, before execution of a SYS{-3) function call. 


System Commands and Functions 
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3.4.10 System Function -4 - Return Privilege Status 


System function -4 returns the privilege status of the current user. 
This allows a privileged program (see section 2.3) to determine if the 
user running the program is privileged or nonprivileged. If the user 
is privileged a value of +1 is returned, but if the user is nonprivi- 
leged a value of 0 is returned. For example: 


AaSeoe-4a 

IF A=1i THEN 188 

sh PRINT "“TLLEGAL OFERATION FOR NONFRIYVILEGED USER” 
48 R=SYoCi2 S REM RETURN TO READY 

166 REM OO RESTRICTED OFERATION HERE 


bed Th 
mi 


ts 
nO 


hee 


CHAPTER 4 


ERROR MESSAGES 


When BASIC encounters an error, execution of the command or statement 
is interrupted and an error message is printed. Most errors are fatal 
and cause BASIC to print the READY message. The condition causing the 


error must be corrected before execution can be continued. 


Certain arithmetic and input errors are nonfatal. BASIC substitutes a 
default value for a nonfatal arithmetic error and resumes execution. 
When data in an illegal format is entered in response to an INPUT 
statement, the request for input is repeated. Nonfatal errors do not 


cause BASIC to print the READY message. 


BASTC detects errors when it executes commands, immediate mode state- 
ments, or program lines. Program lines that are typed are not checked 
for syntax errors until executed. No errors are produced when typing 
program lines or reading them from a file with these exceptions: ?LTL 
(Line Too Long), ?TLT (Too Long to Translate), ?PTB (Program Too Big), 
and ?SYN (SYNtax error ~ caused when program lines in a file contain 


illegal characters). 


When a program is interrupted by an error, BASIC includes in the mes- 
sage the line number of the statement causing the error. It is often 
useful to list this line and examine the values of the variables in 


the line by an immediate mode PRINT statement. 


The cause of the error can be corrected and execution of the program 
continued by the immediate mode GO TO statement. Execution of the 
program can also be started at the beginning by the RUN command. This 
will initialize all variables and delete any open files. To save the 


data in any open files, type an immediate mode CLOSE statement. 
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Error Messages 


All error messages are printed in one of two formats: 

message 
or 

message AT LINE xxxxx 
where xxxxx is the line number of the statement containing the error. 
Error messages produced by immediate mode statements or commands are 
printed in the first format. 
Table 4-1 lists all BASIC error messages. The message produced is in 
the abbreviated form unless BASIC has been assembled with longer error 


messages specified. All error messages are fatal unless the explana- 


tion specifies nonfatal. 


Table 4-1 
BASIC Error Messages 


Abbreviated 
Form 


Longer Form Explanation 


ADDRESS CHECK ERROR Internal system error. If 
error is reproducible, system 
manager should submit SPR. 


?ARG ARGUMENT ERROR Arguments in a function do not 
match, in number, range, or 
type, the arguments defined for 
the function. 


for the arrays specified in the 
DIM statements. If the array can-| 
not be made smaller, then reduce | 
the size of the program (see | 
section 3.2). Alternatively, | 
a virtual array file may be 
used instead of an array in 

memory. 


| 
| 
?ATL ARRAYS TOO LARGE Not enough memory is available | 
| 
| 


BAD DATA READ Illegal characters in data item 
input from a file or from a 


DATA statement. 


Nonfatal, expression in LOG or 
LOG10 function is zero or nega- 
tive, BASIC returns a value of 
zero and continues execution. 
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Table 4-1 (Cont.) 
BASIC Error Messages 


Abbreviated 
Form 


Longer Form Explanation 


BAD DATA - RETYPE FROM item entered in re- 


ERROR 


Nonfatal, 
sponse to an INPUT or INPUT #9 
statement is in wrong format. 


; ie 2 
Retype item and p 


continue. 


a 
rogram will 


tw 


BUFFER STORAGE OVERFLOW Not enough room available for 


| 
| | 
?BSO | 
file buffer in user area or 
| system I/O area. Reduce pro- 
| gram size (see section 3.2). 
?CAO CHANNEL ALREADY OPEN | OPEN statement specifies a 
! channel (logical unit number) 
| which is already associated 
| with an open file. | 
I t 
?CHN CHANNEL NUMBER FAULT | Internal system error. If | 
: error is reproducible, system 
| manager should submit SPR. | 
i 
?CNO CHANNEL NOT OPEN ' A PRINT #, PRINT USING #, INPUT | 
#, IF END #, or CLOSE statement | 
specifies a channel (logical | 
unit number) not associated i 
with an open file. | 


All device channels are cur- 
rently in use. Caused by OPEN 
statement. Retry operation 
later. 


CHANNEL POOL EMPTY 


?DEV NO DEVICE HANDLER Handler is not currently avail- 
able to BASIC users. Notify 
the system manager. If the 
handler is present on the sys- 
tem device and has been loaded 
correctly (if in a F/B environ- 
ment) and error is reproducible, 
submit SPR. 

?DHE DEVICE HARDWARE ERROR 
been detected. This is often 
caused by an off-line or write- 
locked device. If error is re- 
producible and not caused by 

an off-line device or by output 
to a write-locked device, no- 
tify the system manager. 

?DIR DIRECTORY I/O ERROR An error has been detected dur- 
ing an RT-1l directory opera- 
tion. This is often caused by 

a write-locked device. If er- 
ror is reproducible and not 
caused by a write-locked device, 
notify the system manager. 


a A A NN a A IEEE TERN RR rina SA ay “ER mRNA EERE APNG RO sii ths Mn LaOe SEED 


| 
| 
A device hardware error has 
| 
1 
| 
| 
i 
| 
| 
| 
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Table 4-1 (Cont.) 
BASIC Error Messages 


Abbreviated 
Form 


Longer Form Explanation 


DIRECTORY OVERFLOW There is no room in directory 
for a new file. Delete old 
files from device or use another 


device. 


DEVICE NOT AVAILABLE The device requested is cur- 
vently in use by another user 
or another job (when the RT-11 
Background/Foreground monitor 
is used). Use another device 
or try again later. This error 
message is also produced by an 
attempt to ASSIGN a public de- 
vice. 


?DNE DEVICE NOT ENABLED Device is in LOCAL mode or not 
properly mounted. Enable de- 
vice and retry, or use another 


device. 


2?ENL END NOT LAST END statement is not the high- 
est numbered program line. | 
Caused when END statement is | 
executed and a program line has 

a line number higher than the 


END statement line number. 


PETC EXPRESSION TOO COMPLEX 


The expression being evaluated 
caused stack overflow because 
it is too complex. This is usu- 
ally caused by user-defined 
functions or nested functions. 
The degree of complexity that 
produces this error varies ac- 
cording to the amount of space 
available in the stack at the 
time. Breaking the statement 
up into several simpler ones 
eliminates the error. 


Illegal EMT coded. 
Overlay read error. 
Fatal system error. 
Trap to location 4 or 1. 


?F-OVL none 
?F-SYS none 
?F-TRP none 


These are four fatal system er- 
rors. The message will be 
printed on the console terminal 
and will not include AT LINE 
XXXXX. Control will return to 
the RT-1ll Monitor. The system 
manager must reload BASIC. If 
the error is reproducible and 
not due to a user programming 
error in an assembly language 
routine, submit SPR. 


nate enenpemneesseswteernememnnne tee tase ‘eschmmsnemssn Senet a remnssenenenn trier eresersameneevsnsrunrsasunentitnsthatetutnsthnn Aetna 
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Abbreviated 


Form 
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Table 4-1 (Cont.) 
BASIC Error Messages 


1 
?FNF 
?FOV 
| 
| 
| 
| 


oFSV 
i 


FUNCTION ALREADY DEFINED| The user-defined function is 


ERROR IN FETCH 


FILE NOT FOUND 


FLOATING OVERFLOW 


FILE PROTECTION VIOLA- 
TION 


FORMAT ERROR 


NESTED FOR STATEMENTS 
WITH SAME CONTROL 
VARIABLE 


FILE TOO SHORT 


previously defined. 


| Device contains a bad block or 
is offline. Notify your sys- 
tem manager if the device is 
not offline. If error is not 
due to an offline device ora 
bad block and is reproducible, 
submit SPR. 


The file requested is not on 
the specified device. 


Nonfatail, the absolute value 
of the result of a computation 
is greater than the largest 
number that may be stored by 
BASIC (approximately 109°). aA 
vaiue of zero is given to the 
expression and BASIC continues 

; execution. 

| Restricted file operation has 

been attempted. 


Format string error occurs in 
PRINT USING statement or an 
attempt was made to print item 
in the wrong type of data 
field. 


A FOR statement is inside a 
FOR-NEXT loop that specifies 
the same control variable that 
the FOR statement specifies. 


The specified or default FILE- 
SIZE in a data file opened for 
output is not large enough to 
hold the data. 
closed and all data is lost. 


Specify larger FILESIZE in OPEN 


statement. If this error mes- 
sage is produced by a SAVE or 
REPLACE command, save the pro- 
gram on cassette, magtape, or 
paper tape (if available) and 


The file is not 


| | | notify system manager. | 
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Table 4-1 (Cont.) 
BASIC Error Messages 


Abbreviated 


Form Longer Form Explanation 


?FUN FLOATING UNDERFLOW Nonfatal; the absolute value 
of the result of a computation 
is smaller than the smallest 
number that BASIC_can store 
(approximately 10 ?8). A value 
of zero is given to the expres~ 
sion and BASIC continues exe- 
cution. 


?FWN FOR WITHOUT NEXT The program contains a FOR 
statement without a correspond- 
ing NEXT statement to terminate 
the loop. 


?FZD FLOATING ZERO DIVIDE Nonfatal; computation includes 
a division of some quantity by 
zero. The expression is given 
a value of zero and BASIC con- 
tinues execution. 


?ICN ILLEGAL CHANNEL NUMBER The channel (logical unit num- 
ber) specified is not in the 
range 1-127 or the IF END state- 
ment specifies a file on a ter- 
minal. 

2? IDM ILLEGAL DIM A subscript in a DIM or COMMON 
statement is not an integer 
number or an array is dimen- 
sioned more than once. 

?IDT ILLEGAL DATA TYPE The statement assigns a value 
greater than 32,767 or less 
than -32,768 to an element in 
an integer virtual array file. 

?IFL ILLEGAL FILE LENGTH The FILESIZE specified in the 
OPEN statement exceeds the 
maximum size allowed. Error 
is also produced when FILESIZE 
specified is less than 1 for 
nonprivileged users (or less 
than -l for privileged users). 


?IFS ILLEGAL FILE The file specification does not 
SPECIFICATION conform to the required syntax, 
or contains illegal characters. 
Legal characters are the letters 
A through Z, the digits @g through 
9, and the special symbols ".", 
oo mo (blank), SN ae and 
| "@" which must be used as | 
| described in section 2.2. | 


| | | | 
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Table 4-1 (Cont.) 
BASIC Error Messages 


Abbreviated 


Form 


| 
io 
: 


? INS 


?IRS 


?LTL 


?MSP 
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Longer Form 


ILLEGAL IN IMMEDIATE 
MODE 


ILLEGAL NUMBER OF 
SUBSCRIPTS 


ILLEGAL RECORD SIZE 


LINE TOO LONG 


MISSING SUBPROGRAM 


Explanation 


An attempt has been made to 
OPEN FOR OUTPUT a read-only de- 
vice (high-speed paper tape 
reader) or to OPEN FOR INPUT a 
write-only device (line printer, 
high-speed paper tape punch). 
For example, the statement: 

OPEN "LP:" AS FILE 1 will gen- 
erate this error message be- 
cause FOR INPUT is assumed when 
neither is specified. 


The INPUT statement has been 
entered in immediate mode. 


More than two subscripts are 
specified in a DIM or COMMON 
statement or the array is di- 
mensioned with one subscript 
and referenced by two or vice 
versa. 


The OPEN statement specifies a 
RECORDSIZE less than one for 
unprivileged users or specifies 
a RECORDSIZE of zero or less 
than minus one for a privileged 
user. 


ment specifies a string length 
outside the range 1-255. 


String virtual array OPEN state- 


An attempt has been made to 
enter a line longer than 132 : 
characters; the line is ignored. 
If this message occurs when 
BASIC is reading a program from 
a file, BASIC stops reading the 
file. 


Occurs when assembly language 
routines have been included with 
BASIC and a CALL statement 
specifies a nonexistent routine 
name. This error can also be 
caused by a syntax error in the 
first element of a line. BASIC 
interprets this error as an 
implied call statement. 
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Table 4-1 (Cont.) 
BASIC Error Messages 


Abbreviated | 
Form Longer Form Explanation | 


?NER NOT ENOUGH FILE SPACE The device contains insuffi- 
cient free space to accommodate 
the requested file. Try again, 
and specify a smaller FILESIZE 
in the OPEN statement or a dif- 
ferent device. This error mes- 
sage is also produced when one 
user attempts to open more than 
one file simultaneously on one 
cassette or magtape unit. If 
this message occurs when access- 
ing a public device, notify the 
system manager. 


?NFS NOT FILE STRUCTURED An attempt has been made to 
open a virtual file on a device 
other than DECtape or disk. 


?NGS NEGATIVE SQUARE ROOT Nonfatal, the expression in the 
SOR (square root) function has 
a negative value. The square 
root of the absolute value of 
the expression is returned and 
BASIC continues execution of 
the program. 


?NOB NUMBER OUT OF BOUNDS The absolute value of a numeric 
constant specified in a state- 
ment or in the VAL function is 
less than the smallest number 
BASIC can store (approximately 
10 °®) or is greater than the 
largest number BASIC can store 
(approximately 103°). 


?NRH NO ROOM FOR HANDLER Currently the system I/O area 
has insufficient space for the 
non-resident handler of the re- 
quested device. If possible 
use another device or retry the 
operation again later. 


?NSM NUMBERS AND STRINGS String and numeric values ap- 
MIXED pear in the same expression or 
they are set equal to each 
other; for example, AS=2. 


?NVD NOT A VALID DEVICE The device name is not valid or 
is not available to BASIC users. 


| NEXT WITHOUT FOR A NEXT statement has been exe- 

| cuted without a corresponding | 
| | FOR statement. | 
| 


a 
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Table 4-1 (Cont.) 
BASIC Error Messages 


Explanation 


Form | Longer Form 
file has been reached and the 


| ?O0OD | OUT OF DATA The data list has been exhausted 


Abbreviated | 
| 
and a READ statement requests 
additional data or the end of a 
1 
INPUT # statement requests ad- 
ditional data. 
| 
| 
| 
| 
| 
| 
| 
i 
| 
| 


A nonprivileged user has at- 
FUNCTION tempted to execute a privileged 
system function call. 
?PTB PROGRAM TOO BIG The line just entered causes 


the program to exceed the user 
code area; the line is ignored. 
Reduce program size (see sec- 
tion 3.2). If this error oc- 
curs when BASIC is reading a 

| program from a file, BASIC 

' stops reading the file. 


i 
| 
4 
| 
7PSF | PRIVILEGED SYSTEM 
| 
i 
| 
| 
| 
i 


?RPL | USE REPLACE | An attempt has been made to 

' gave a program in a file that 
:; already exists on the device. 
The operation does not occur 
and the original file is not 
disturbed. Use the REPLACE 
command if the operation is 
intended. 


RETURN WITHOUT GOSUB 


RETURN WI T GOSU A RETURN is encoun 


untered 
execution of a GOSUB sta 


?SOB | SUBSCRIPT OUT OF BOUNDS 
than zero or is outside the' 
bounds defined in the DIM 
statement or outside of the 
limits of the virtual array file. 


ee eR A RNR te: ARAN he mam Ht 


| 
The subscript computed is less | 
STRING STORAGE OVERFLOW Not enough memory is available | 
to store all the strings used 
in the program. Reduce program 
size (see section 3.2). | 
?STL ' STRING TOO LONG The maximum length of a string | 
, in a BASIC statement is 255 
i ; characters. | 


| Abbreviated | 


| 
| 


Form 


?SYN 


cgi lel Bl 


2?TMC 


?TMG 


?UFN 


?ULN 


?USR 


?2+ER 


| 
| 
| 
| 
| 
| 
H 
1 
| 
| 
| 
| 
| 
| 
| 
| 
{ 
i 
| 
I 
i 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
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Table 4-1 (Cont.) 
BASIC Error Messages 


Longer Form 


SYNTAX ERROR 


TOO LONG TO TRANSLATE 


TOO MANY CHANNELS 


TOO MANY GOSUBS 


UNDEFINED FUNCTION 


UNDEFINED LINE NUMBER 


ILLEGAL USR/EXIT CALL 


+ERROR 


| 
, 
| 


| | | than. 255: 


Explanation 


BASIC has encountered an unrec- 
ognizable element. Common 
examples of syntax errors are 
misspelled commands, unmatched 
parentheses, and other typo- 
graphical errors. This mes- 
sage can also be produced by 
attempting to read in a program 
from a file containing illegal 
characters in which case BASIC 
stops reading the file. 


Lines are translated as they 
are entered and the line just 
entered exceeds the area re- 
served for translating; the 
line is ignored. If this mes- 
sage is produced while BASIC is 
reading a program from a file, 
BASIC stops reading the file. 


OPEN statement exceeds the maxi- 
mum number of files that may 

be opened simultaneously by a 
nonprivileged user. 


More than twenty GOSUBs have 
been executed without a corre- 
sponding RETURN statement. 


A user-defined function has 
been used and not defined. 


The line number specified in 
an IF, GO TO, GOSUB, ON GO TO, 
ON GOSUB, CHAIN, or OVERLAY 
statement does not exist any- 
where in the program. 


Internal system error. If er- 
ror is reproducible, system 
manager should submit SPR. 


The program has tried to com- 
pute AtB, where A is less than 
®@ and B is not an integer. 

This would produce a complex 
number which can not be repre- 
sented in BASIC. This message 
is also produced when A is less 
than zero and B is an integer 
with an absolute value greater 


{ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


Error Messag es 


BASIC functions that are called improperly cause error messages to be 
printed. Table 4-2 describes under what conditions BASIC functions 


produce errors. 


Table 4-2 
Error Conditions in BASIC Functions 
Error 
Function Condition Message 


All functions The argument used is the wrong 
type. For example, the argument 
is numeric and the function ex- 
pects a string expression. 


All functions The wrong number of arguments 

has been used in a function, or 
the wrong character has been used 
to separate them. For example, 
PRINT SIN (X,Y) produces a syn- 
tax error because the SIN func- 


| 
| 
| | 
| tion has only one argument. 
ASC (string expr) String expr is not a one character ?ARG 
| | string. 
i i 
| BIN(string expr) | Character other than blank, zero, | ?ARG 
; OY one in string or value is I 
| greater than 2!°. 
i ' 
| CHRS (expr) | Expr is not in the range §-32767. | PARG : 
EXP (expr) Expression is greater than 87. ?+ER | 
FNletter The function FNletter has not ?UFN | 
been defined (function cannot be 
defined by an immediate mode state- | 
ment). | 
LOG (expr) Expression is negative or %. BASIC ?BLG 
| returns a value of @. | | 
| LOG19 (expr) Expression is negative or @. BASIC | ?BLG | 
| returns a value of @. | | 
OCT (string expr) Character other than blank or digits | ?ARG | 
9-7 in string or value is greater 
than 2° *. | | 
: PI An argument is included. | ?ARG | 
| SEG$ (string expr, No additional error conditions. | | 
exprl,expr2) H 
| Seep ’ Lr ’ | | | 
| i 
SOR (expr) | Expression is negative; BASIC returns ?NGS | 
| 
| 
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Table 4-2 (Cont.) 


Error Conditions in BASIC Functions 


Function 


SYS (exprl1[,expr2] ) 


TAB 


VAL(string expr) 


Condition 


A nonprivileged user has attempted to 
execute a privileged system function 
call, 


The value of the first expression is 
less than -4 or greater than 8 or a 
second expression is specified when 
none is expected. 


Expression is not in the range §- 
32767. 


String expr is not a numeric constant. 
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Error 
Message 


APPENDIX A 


ASCII CHARACTER SET 


The following table shows, with the corresponding octal and decimal 
codes, the 128-character ASCII (American Standard Code for Information 
Interchange) character set. These codes are used to store ASCII data 


in files and to store them internally. 


The BASIC user can convert an ASCII value to the corresponding string 


Pat, Renee ear Teen ers + 
character with the CHRS function an 


Qu 


can convert a string character to 
the corresponding ASCII value with the ASC function. These functions 
are described in the BASIC-1l1 Language Reference Manual. A special 
system function (see section 3.4.3) returns the ASCII value of charac- 
ters input from the terminal or a file. 


BASIC aiso uses the ASCII 


ae 
VaLues G&G 


sons. See the BASIC-1l Language Reference Manual for a description of 
string relational operators. 


BASIC converts to upper case all lower case letters entered at the 
terminal. No conversion is done on terminal output or input and 


output with any other device. 
The octal code is provided for reference. BASIC does not support octal 


numbers except through the OCT function (see the BASIC-1ll Language 


Reference Manual). 


eighth (high order) bit is normally zero. 
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Table A-1 
ASCII Character Set 


ASCII 


Decimal 
Code Character 


0 000 NUL (CTRL/@) 
1 001 SOH (CTRL/A) 
2 002 STX (CTRL/B) 
3 003 ETX (CTRL/C) 
4 004 EOT (CTRL/D) 
5 005 ENQ (CTRL/E) 
6 006 ACK (CTRL/F) 
7 007 BEL (CTRL/G) 
8 010 BS (CTRL/H) 
9 O1ll HT (CTRL/I or TAB) 

10 012 NL (NEW LINE or LINE FEED) 
a 013 VT (Vertical TAB) 

12 014 FF (Form Feed) 

13 015 RT (Return) 

14 016 So (CTRL/N) 

15 017 SI (CTRL/O) 

16 020 DLE (CTRL/P) 

17 021 DC1 (CTRL/Q) 

18 022 DC2 (CTRL/R) 

19 023 DC3 (CTRL/S) 

20 024 Dpc4 (CTRL/T) 

21 025 NAK (CTRL/U) 

22 026 SYN (CTRL/V) 

23 027 ETB (CTRL/W) 

24 030 CAN (CTRL/X) 

25 031 EM (CTRL/Y) 

26 032 SUB (CTRL/Z) 

27 033 ESC (ALTMODE) 
28 034 FS (CTRL/\ ) 

29 035 GS (CTRL/]) 
30 036 RS (CTRL/*) 

31 037 US (CTRL/ ) 

32 040 SP (space bar) 
33 041 : 

34 042 " 

35 043 # 

36 044 $ 

37 045 % 

38 046 & 

39 047 ’ 

40 050 ( 

41 051 ) 

42 052 i 

43 053 + 

44 054 

45 055 7 

46 056 < 

47 057 / 

48 060 0 

49 061 1 

| 50 062 2 
51 063 3 
| 52 | 064 | 4 
53 065 5 
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Table A-1l (Cont.) 
ASCII Character Set 


ASCII 
ASCII 7-Bit 
Decimal | Octal H 


Character 


| 6 
| 7 
56 070 | 8 

57 071 9 

58 | 072 : | 

59 073 ; 

60 | 074 < | 

61 | 075 = | 

62 076 > | 

63 | 077 ? | 

64 100 @ | 

65 | 101 A 
| 66 102 | 3B | 
| 67 | 103 | ¢ | 
68 | 104 | oD 
| 69 | 105 | E 
| 70 | 106 | FP 
| 71 | 107 | ¢ | 
72 110 | #H 
73 114 i 
| 74 £12 by 
| 75 | is | x | 
76 114 ae 
77 115 | ! 
| 7 | 116 | oN | 
| 79 117 O | 
| 80 120 P 

81 121 Q 
82 122 R 

83 123 S 
| g4 124 | T | 

85 125 U | 
| 86 136 | Vv | 

87 127 | ow | 

88 130 | x | 
| 89 | 131 1 oy 
| 90 | 132 lz | 
| 91 | 133 Lal | 
| 92 | 134 r \ 

93 135 ] 

94 136 4 or * 

95 i | ie) ee 
| 96 140 | | 
| 97 141 la | 
| 98 142 | b | 

99 143 c 
| 100 | 144 | a | 

101 145 | oe | 
| 102 146 | £ | 
| 103 147 log 

104 150 | oh 
| 105 161 | 4 
| 106 152 | 5 | 
| 107 153 | k | 
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Table A-1l (Cont.) 
ASCII Character Set 


ASCII 
Decimal 
Code Character 


2 
m 
n 
° 
p 
gq 
r 
s 
t 
u 
Vv 
wW 
x 
eg 
Z 
{ 
| 
} 


APPENDIX B 


SUMMARY OF BASIC STATEMENTS, FUNCTIONS, AND COMMANDS 


This appendix summarizes the statements, functions, and commands in 
MU BASIC/RT-11. These summaries supersede the summaries provided in 


the BASIC-11 Language Reference Manual. 
B.1 DOCUMENTATION CONVENTIONS 


Certain conventions are used to describe the format of the BASIC lan- 
guage throughout this document. Tables B-l and B-2 describe these 
conventions. See the BASIC-11l Language Reference Manual for a more 


complete description of the terms used. 


Table B-l 
Documentation Conventions 


Convention Meaning 


Elements to be supplied by user according 
to rules explained in the text. Table B-2 
provides a description of some frequently 
used elements and abbreviations. 


' Ttems in lower- 
case letters 


| 
| 


Items in capital BASIC keywords, must appear exactly as shown 
letters and because they form the vocabulary of the 
special symbols BASIC-11 language. For example, LET, IF, 


OPEN, RUN, #, and -/. 


Braces A choice of one element among two or more 
| possibilities, for example: | 


je statement 


THEN line number 
GO TO line number 
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Table B-l (Cont.) 
Documentation Conventions 


Convention Meaning 


Square brackets [] Optional element or a choice among optional 
elements, for example: 


[LET] variable = expression 


‘ FOR INPUT 
OPEN string| Fos ourpur | AS FILE #expr 
Ellipsis . Preceding elements may, at the user's option, 


be repeated, for example: 


CLOSE #exprl, #expr2, #expr3, ... 
DEF FNletter (varl[,var2,...,var5])=expr 


Lower-case words that appear in a description of the format of a BASIC 
statement, function, or command represent elements that must be sup- 
plied by the user according to the rules provided. When one of these 
words is repeated a number or letter appendage serves to identify each 
separate element in the explanations. Table B-2 describes the meaning 


and abbreviations used for some elements. 


Table B-2 
Lower-Case Words Used in Format Descriptions 


expression 


Meaning 


expr Any valid BASIC expression. 


string expression string expr Any valid BASIC string expression. 


integer int Any positive integer (must be a 


numeric constant). 
line number Any legal line number. Must be a 
one to five digit number within 
the range 1 to 32,767. 


relational operator rel-op An arithmetic or string relational 


operator. 


variable A name representing a numeric 


or string variable. 
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B.2 SUMMARY OF BASIC STATEMENTS 


The following summary of BASIC statements defines the general format of 


each statement and gives a brief explanation of its use. Square brack- 


ets [] indicate optional elements. 
[CALL “]Jroutine name["] (argument list) 


Used to call assembly language routines from a BASIC program. The 
word CALL and the pair of quotation marks should either both be 
excluded or both be included. 


CHAIN string [LINE line number] 
Terminates execution of the program, loads the program specified 
by string, and begins execution at the lowest line number or, 
when a line number is present in the CHAIN statement, at the 
specified line number. The string may be any string expression 
and is a file descriptor as described in section 2.2. 


CLOSE [[#]exprl, [#] expr2, [#] expr3, ...,VFintl,VFint2,...] 
Closes the file(s) associated with the logical unit number(s) and 
virtual file logical unit number(s) specified. If no logical unit 
number is specified, closes all open files. 
TT OE EEE EE ESS TOE DE ET ST ES IS 


COMMON ‘vari [ (imtL[,i1nt2])). var2 Unt); int2)) 5.2. 


Preserves values and names of specified variables and arrays when 
the CHAIN statement is executed. Both string and arithmetic vari- 
ables and arrays can be passed. The statement also dimensions 

the specified arrays. 


DATA number [,"string",number,...] 


Used in conjunction with to input listed data into an exe- 
cuting program. Can contain any mixture of strings and numbers. 
DEF FNletter (varl{,var2,...,var5])=expression 
Seo ee 
Defines a user function. Letter may be any single letter A 
through Z. 
DIM var(intil [, int2})yvar2 (intl [,int2]) >. 


Reserves space in memory for arrays according to the subscript (s) 
specified after the variable name. 


END Optional, placed at the physical end of the program to terminate 
execution. 


FOR var = exprl TO expr2 [STEP expr3] 


— a 


Sets up a loop to be executed the specified number of times. 


GOSUB line number 


Seen 


Unconditionally transfers control to specified line of subroutine. 
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GO TO line number 
EEO 
Unconditionally transfers control to specified line number. 


THEN statement 
IF exprl rel-op expr2 |) THEN line number 
er GO TO line number 


Conditionally executes the specified statement or transfers con- 
trol to specified line number. When the condition is not satis- 
fied, execution continues at the next sequential line. The ex- 
pressions and the relational operator must all be string or all 
be numeric. 


THEN statement 
IF END #expr ( THEN line number 
=<? GO TO line number 


Tests for end-of-file condition of input sequential file associ- 
ated with logical unit expr. 


INPUT [texpr {? | ] varl[{,var2,...] 


Inputs data from the file associated with the logical unit speci- 
fied by expr or from the user's terminal. Variables may be arith- 
metic or string. #expr can be followed by a comma or a colon. 


KILL string expr 


Deletes file specified by string expr. 


[LET] variable = expression 


Assigns value of expression to the specified variable. Variable 
and expression must be of the same type - either numeric or string. 
[LET] VFinteger(exprl) = expr2 
eet 


Assigns value of expr2 to the exprl element of the virtual file 
VF integer. The data type of the virtual file and of expr2 
must be the same - either numeric or string. 


LINPUT [texpr{}1 varl[,var2,...] 
anaes 


Equivalent to INPUT (for compatibility only). 


NAME string exprl TO string expr2 


nad 


a file specified by string exprl to name specified by string 
expr2. 


NEXT variable 


Placed at end of FOR loop to return control to FOR statement. 


ON expression GOSUB line numberl [, line number2, line number3,...] 
AD Cen 
Conditionally transfers control to subroutine at one line number 
specified in list. Value of expression determines the line num- 
ber to which control is transferred. 
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ON expression GO TO line numberl [, line number2,line number3,...] 


aa 


Conditionally transfers control to one line number in the list. 
Value of expression determines the line number to which control 
is transferred. 


TT 
OPEN string Fon sneer] 3S FILE[#]expri[DOUBLE BUF][,FILESIZE expr2][,RECORDSIZE expr3][{,MODE expr4] 
as REPAIRER 


Opens a file specified by string for input or output as specified 
(assumes input if neither specified) and associates file with the 
logical unit expri. String expr is a file descriptor as described 
in section 2.2. 


Z 


OPEN string . AS FILE VF int 3) [ (exprl1)][=expr2][,FILESIZE expr3] 


ES 


FOR OUTPU 


Ee INPUT 
$ 


Opens a virtual array file specified by string. FOR OUTPUT creates 
a new file; FOR INPUT (or neither) allows either output or input to 
an existing file. Elements may be assigned a value by the LET VF 
statement. When %@ (percent sign) is specified, the data type is 
integer; when $ (dollar sign) is specified the data type is string; 
and when neither is specified, the data type is floating point. 
exprl specifies the dimension and expr2 specifies the string 

length (used with $ only). 


OVERLAY string expr [LINE line number] 


Overlays or merges the program currently in memory with the program 
in the file specified by string, and when overlay is completed, 
transfers control to either the next sequential BASIC line number 
or the line number specified. String expr is a file descriptor 

as described in section 2.2 


PRINT [#expr cet ] [exprl,expr2,expr3,...] 


Prints vaiues of expressions on the terminal or, when specified, 
to the file associated with logical unit expr. Expressions can 
be numeric and string. The TAB function can also be included. 
Elements can be separated by either commas or semicolons. #expr 
can be followed by a comma or a colon. 


PRINT [#expr vf ] USING string, [exprl,expr2,expr3,...] 
Prints values of expressions on the terminal or, when specified, 
to the file associated with logical unit expr in the format deter- 
mined by string. Both numeric and string expressions can be 
used. Elements must be separated by commas. 


RANDOMIZE 
en Ey 


Causes the random number generator (RND function) to produce 
different random numbers every time the program is run. 


READ varl[,var2, var3,...] 


Assigns values listed in DATA statements to specified variables. 
Variables may be string or numeric. 
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REM [comment] 
EEE 


No effect on execution of program. Contains explanatory comments 
in a BASIC program. 


RESET [[#] expr] 


Equivalent to RESTORE. 


RESTORE [[#]expril,[#]lexpr2,[#]expr3,...]] 


ad 


Resets either the data pointer or, when specified, the input 
file(s) associated with logical unit number(s) specified to the 
beginning. File(s) must be on file structured devices. 


RETURN 
— memeeenel 


Terminates a subroutine and returns control to the statement fol- 
lowing the last executed GOSUB statement. 

STOP 

ee 


Terminates execution of the program. Placed at logical end(s) of 
the program. 


B.3 SUMMARY OF BASIC FUNCTIONS 


ARITHMETIC FUNCTIONS 
La eed 


The following functions perform standard mathematical operations in 
BASIC. 


Name Explanation 
ABS (expr) Returns the absolute value of expr. 
ATN (expr) Returns the arctangent of expr as an angle in 


radians in the range + or - pi/2. 
COS (expr) Returns the cosine of expr radians. 


EXP (expr) Returns the value of etexpr where e is (approxi- 
mately) 2.71828. 


INT (expr) Returns the greatest integer less than or equal 
to expr. 
LOG (expr) Returns the natural logarithm of expr. 
LOG10 (expr) Returns the base 10 logarithm of expr. 
PI Returns the value of pi = 3.141593 (approximately). 
RND[ (expr) ] Returns a random number between 0 and l. 
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Name Explanation 
SIN (expr) Returns the sine of expr radians. 
SOR (expr) Returns the square root of expr. 
TAB (expr) Causes the terminal type head to tab to colum 
number expr (valid only in PRINT statements). 
LEE FEO M EAL IE SL LETTE 7 
SYS (exprl[,expr2]) Special system function calls; control terminal 
input/output and perform special functions. 
When exprl is: System Function 
0 Cancels effect of a CTRL/O typed at terminal. 
1 Disables echoing and enters special mode for in- 


putting tapes on the low speed reader. 


2 Enables echoing; cancels effect of SYS(1) and 
SYS (3). 

2 Disables echoing. 

4 Returns the ASCII value of the next character 


typed at the terminal; if specified, expr2 is the 
logical unit number associated with the file from 


which the next character should be read. 


5 Deletes current program; changes program name to 
NONAME; and returns to the READY message. 


6 Set the terminal margin to the value of expr2. 
7 Enables CTRL/C as interrupt. | 
8 Privileged; disables CTRL/C as interrupt. 

-1l Privileged function; sets the user ID to that 


specified by the ASCII value in expr2; if 

expr 2=ASC ("X")+256*ASC("Y") then the ID will be 
"X¥". Unprivileged if expr2 is negative, in 
which case it returns current user ID. 


-2 Clears privileged user bit; user will not be 
able to execute any privileged functions or 
file operations. 


-3 Privileged function; returns to RT-11 Monitor. 


~4 Returns privilege status; zero for nonprivileged 
and one for privileged. 
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STRING FUNCTIONS 
TE ED 


The string functions are: 


ASC (string expr) Returns as a decimal number the 8-bit internal 
code (ASCII value) for the l-character string 
expr. 

BIN(string expr) Converts a string expression containing a bi- 

Cred bw~t dec nary number to a decimal value. Blanks are 
ignored. 

CHRS (expr) Generates a l-character string whose ASCII value 


is the low-order 8 bits of the integer value of expr. 


DATS Returns the date as a string in the form 
dd-mon-yr (for example %7-FEB-75). 


LEN (string expr) Returns the number of characters in the string 
expr. 
OCT (string expr) Converts a string expression containing an octal 


Conv oct TeEDEG Number to a decimal value. Blanks are ignored. 


POS (string exprl, Searches for and returns the position of the 
string expr2, first occurrence of string expr2 in string 
expr) exprl. The search starts at the expr character 

position in string exprl. 


SEGS$ (string expr,exprl,expr2) 
Returns the string of characters in positions 
exprl through expr2 in string expr. 


STRS (expr) Returns the string which represents the numeric 
value of expr. 


TRMS (string expr) Returns string expr without trailing blanks. 
VAL(string expr) Returns the value of the decimal number contained 


in the string expr. 


B.4 SUMMARY OF BASIC COMMANDS 


Command Explanation 


APPEND [file descriptor] Merges the program in core with the program 
specified by the file descriptor. 


ASSIGN device: Assigns specified device to the user if it is 
available. 
BYE Terminates the session of the user issuing 


the command; deletes all open output files 
and deassigns all devices. 


CLEAR Initializes all variables to zero, and all 
string variables to nulls and deletes arrays. 


DEASSIGN[device:] Deassigns the specified device or all assigned 
devices. 
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Command 
HELLO 
KEY 
LENGTH 
LIST[NH] [line number] 


p~iine number, 
-END 


NEW[program name] 


OLD[file descriptor] 


RENAME [program name] 


REPLACE [file descriptor] 


RUN [NH] 


RUN[NH] file descriptor 


SAVE[file descriptor] 


SCR[ATCH] 


SET TTY type 


TAPE 


UNSAVE[file descriptor] 


Explanation 


Special command to get started with BASIC. 
Enables echoing after TAPE command or SYS(1) 
or SYS(3) function call. 


Displays on the terminal the size of the pro- 
gram in memory and the size of the remaining 
free memory. 


Prints on the terminal the specified line(s) 
of the program currently in memory. NH sup- 
presses the printing of the header line. 


Erases the entire storage area of user and 
sets the current program name to the one 
specified. 


Erases the entire storage area of user and 
inputs the program from the specified file. 


Changes the current program name to the one 
specified. 


Replaces the specified file with the current 
program. 


Executes the program in memory. 
the printing of the header line. 


NH suppresses 


Erases the entire storage area of user, in- 
puts the program from the specified file, and 
then executes the program. Does not print 
header line in any case. 


Outputs the program in memory as the specified 
file (can be used to list a program on the 
line printer or punch it on the high-speed 
paper tape punch). 


Erases the user's entire storage area, but 
preserves the program name. 


Sets system to allow different terminals; 
type may be VT05, ASR33, or LA30. 


Disables echoing for entering tapes from the 
low-speed reader. 


Deletes specified file. 
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Key Commands 


Key Explanation 
CTRL/C Interrupts execution of a command or program and 


causes BASIC to print the READY message. The 
execution of SYS(8) function call disables CTRL/C. 
Echoes as "tc", 


CTRL/O Causes all further terminal output to be discarded. 
If an INPUT statement is encountered, a SYS(@) 
function call is executed, or CTRL/O is retyped, 
printing resumes. Occasionally CTRL/O suppresses 
the printing of the READY message. Echoes as "tO". 


CTRL/Q Continues output to the terminal; cancels effect 
of CTRL/S. May be XON on some terminals. Does 
not echo. 


CTRL/S Temporarily suspends all output to terminal until 
CTRL/Q is typed; allows alphanumeric display ter- 
minals (VT0O5) to be read or photographed before 
data is moved off screen. May be XOFF key on 
some terminals. Does not echo. 


CTRL/U Deletes the entire current input line (provided 
the RETURN key has not been typed). BASIC dis- 
plays 

4U 


at the end of the line. For example: 


10 BLET A +U 


t 


CTRL/U typed here. 


RUBOUT Deletes the last character typed and echoes as a 
backarrow (underscore on some terminals) on the 
terminal. For example, 


FOR N = 31 TO 3 


. 


RUBOUT typed here. 


RUBOUT can be repeated to delete any character 
up to the beginning of the line. Snaces are 
considered valid characters and are deleted by 
RUBOUTS. 
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VIRTUAL ARRAY FACILITY 


The virtual array facility allows a BASIC program to operate on data 
structures that are too large to be accommodated in memory at one time. 
To accomplish this, BASIC uses the disk file system for storage of 
data arrays, and maintains only portions of these files in memory at 


any given time. 


An essential difference between real arrays and their virtual counter- 
parts is the time required to reference array elements. In real ar- 
rays, the referencing order has no effect on the time required to 
reference an element. In virtual arrays, this order can have a signi- 
ficant effect on the program execution time. This appendix describes 
the algorithms used in the virtual array processor, so that users may 


optimize their use of this facility. 


Each MU BASIC/RT-11 disk file is a contiguous sequence of 256-word 
records. Any position in a file can be specified internally with a 
2-component address; the first component is the relative block within 
the file, the second is the position of the item within the block. 
One of the functions of the virtual array processor is to transform 
each virtual array reference into its corresponding file address. 
This is called mapping. 


Virtual arrays are stored as unformatted binary data. This means that 
no I/O conversions need be performed in storing or retrieving elements 
in virtual storage. Thus, there is no loss of precision in these ar- 


rays, and no time wasted performing conversions. 


All references to virtual arrays are ultimately located via file ad- 


dresses relative to the start of the file. No symbolic information 
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concerning dimensions or data types is stored within the file. Thus, 
different programs may use different data types to refer to the data 
contained within a single virtual array file. The user must be 
cautious in such operations, since it is the user's responsibility to 
ensure that all programs referencing a given set of virtual arrays are 


referencing the correct data. Consider the following example: 
Program ONE contains 


10 OPEN "FILE" AS FILE VF13 


Program TWO contains 
10 OPEN "FILE" AS FILE VF2 


Whenever program TWO references the array VF2, it is using the data 
known to program ONE as array VFl. VF2 contains floating-point data 
while VF1l contains integer data. These two arrays do not correspond 
in data type and the data program ONE creates may be meaningless to 


program TWO and vice versa. 


NOTE 


A virtual file should not be simultaneously 
opened under two or more different channels 
(by one user or two) and have data changed 

on more than one channel. For example: 


50 OPEN "VALUES" AS FILE VF1 (100) 
60 OPEN "VALUES" AS FILE VF2 (100) 
70 VF1(1) 10 
80 VF2(2) 20 


Only ore of these two assignment statements 
is effective. The other value is lost, 
because two buffers have been created and 
the last buffer to be written out destroys 
the changed data in the first buffer writ- 
ten out. 


C.1 ARRAY STORAGE 
Strings in virtual storage occupy pre-allocated (determined by OPEN 


statement) space in the virtual file, and thus differ from strings in 


Memory storage, where space is allocated dynamically. A virtual file 
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containing strings can be considered to be a succession of fields, 
each of the maximum string length. When a string in a virtual file is 
assigned a new value, it is stored left-justified in the appropriate 
field. If the new string is shorter than the maximum iength, the re- 
mainder of the field is filled with null characters. When the string 


is retrieved, the trailing null characters are removed. 


Table C-1l describes the number of elements of each data type that can 
be stored in one 256-word (512-byte) block. 


Table C-1 
Virtual Array Storage Capabilities 


Number Number 
Data Type Bytes per Element Elements per Block 
Floating Point 4 
Integer (8%) 2 


String 32 16 | 


| 
String ($=string length) string length 512/string length | 


The string length must be in the range 1-255. The number of string 


elements per block can be fractional. 


C.2 TRANSLATION OF ARRAY SUBSCRIPTS INTO FILE ADDRESSES 


In order to translate an array subscript into a file address, BASIC 
computes the relative distance from the specified item to the first 
item in the array. This is computed from the array subscript and the 
number of elements per block, as shown in Table C-l. The relative 
distance is added to the starting address of the file (determined by 
the OPEN statement processor) to find the address of the block con- 


taining the item. 


Since the OPEN statement contains the only information used to define 
the structure of a file, it is possible for the user to specify dif- 
ferent accessing arrangements for the same file in one or more pro- 


grams. For example, the user can reference the same data as a series 
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of either 32-byte strings or l16-byte strings, with the following state- 


ments: 


10 OPEN "ABC" AS FILE VF1S (1998) = 16 


30 OPEN "ABC" AS FILE VF2S (589) = 32 


The user should keep in mind that in MU BASIC/RT-1l, as in most BASICs, 
array subscripts begin with 0, not 1. An array with dimension n actu- 
ally contains n+l elements. 


C.3 ACCESS TO DATA IN VIRTUAL ARRAYS 


Only a portion of a virtual array is in memory at any given time. This 
data is transferred directly between the device and an I/O buffer, cre- 
ated when the OPEN statement is executed. This buffer must be 256 
words (one block) long, and may not be specified as several blocks with 
the RECORDSIZE or DOUBLE BUF option in the OPEN statement. For each 
virtual array file, BASIC notes 


the block of the file currently in the buffer 


whether the data in the buffer has been modified since 
it was read into memory 


After BASIC translates a virtual array address into a file address, it 
checks whether the block that contains the referenced item is currently 
in the buffer. If the necessary block is present the reference pro- 
ceeds; but if not, another portion of the file is read into the buffer. 
If the current data in the buffer has been altered, it is necessary to 
rewrite this data on the device prior to reading new data into the 
buffer. 


The virtual array accessing algorithm is flow chartel in Figure C-l. 
Users should design the order in which virtual file elements are refer- 
enced in their programs to minimize the reading and writing of blocks. 


C.4 ALLOCATING DEVICE STORAGE TO VIRTUAL FILES 


The FILESIZE or dimensions indicated in an OPEN statement set maximum 
allowable values for subscripts and are used to compute the initial 
size of the virtual file to be allocated on the device. The contents 
are not initialized to zero. The data previously recorded in a block 
(when it was part of another file) is available to the new owner of 


c-4 


Virtual Array Facility 


VIRTUAL ARRAY 
REFERENCE 


TRANSLATE SUB- 
SCRIPT INTO FILE 
ADDRESS 


Is 
THIS 
BLOCK IN 
BUFFER 


CURRENT 
BLOCK BEEN 
ALTERED 


REWRITE BLOCK 
IN FILE 


CLEAR 'MODIFIED' - 
INDICATOR 


READ NEW 
FILE BLOCK 


ING ELEMENT 
IN BUFFER 


SET 'MODIFIED' 
INDICATOR 


PROCEED WITH 
OPERATION 


Figure C-1l 


Virtual Array Accessing Algorithm 
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the block. Users whose files contain confidential information should 
explicitly overwrite all data in such files, prior to file deletion, 
in order to protect data contained therein. 
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MU BASIC/RT-11 PROGRAM STRUCTURE 


MU BASIC/RT-11 stores each user's program in memory in the following 
format: 


| Buffers | 


| Strings 


| Symbol Table | 


The symbol table and user code area are created when the program is 
entered. When the RUN command is given, the user program is scanned 
and arrays are set up. The string area is created during program exe- 
cution. 


The SCRatch command clears all the user code, symbol table, strings, 
and arrays from memory. The CLEAR command clears the arrays and 
strings but does not affect the user code or symbol table. 


A symbol table entry is created for each distinct line number (four 
bytes) or variable name (ten bytes) referenced in the program. 

These entries are not deleted, however, even when all references in 
the program to a particular line number or variable are removed. 
Thus, if the program in memory is heavily modified, it may be desir- 
able to save it with the SAVE command and then restore the program 
with the OLD command to obtain the largest possible user area. 
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MU BASIC/RT-11 Program Structure 


User-entered blanks that are not in REM statements or string constants 
and blanks produced by BASIC when listing or saving a program do not 
contribute to the size of the program in memory. The total amount of 
memory storage required to store a BASIC program (user code and symbol 
table) depends on the parameters (2 bytes = 1 word) listed in Table 
D-1. 


Table D-1l 
Parameters in Memory Storage of BASIC Programs 


Total number of lines in the BASIC 
program. 


Total number of tokens in the pro- 
gram (see below for a description 
of BASIC tokens). 


Total number of distinct variable 
names used in the program (in this 
context, a scalar and an array vari- 
able with the same name are con- 
sidered to be the same variable 
name). 


Total number of occurrences of vari- 
able names and references to line 
numbers in the program (not includ- 
ing the line number at the beginning 
of each line). 


Total number of integer constants 
whose absolute value is in the 
range 0<x<255. 


Total number of integer constants 
whose absolute value is in the 
range 255<x<32767. 


Total number of noninteger numeric 
constants and integer constants not 
in above ranges. 


Total number of NEXT statements in 
the program. 


Total number of references to the 
name of a user-defined function; 
e.g., FNA (including the definition 
itself). 


Total number of REM statements, im- 
plied CALL statements, and string 
constants. 
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Table D-1 (Cont.) 
Parameters in Memory Storage of BASIC Programs 


Cc | Cc | Total number of characters in all 
| | | 


REM and implied call statements and 
string constants (number of charac- 
ters following REM, number of char- 
acters in an assembly language rou- 
tine name, number of characters be- 


aL Ne hee Nee 


tween (but not including) the quotes 
in a string constant). 


End of program token. 


When programs are entered, BASIC converts certain words and special 
symbols (both are called keywords) to l-byte tokens to conserve memory. 
Some BASIC keywords are: PRINT, IF, and THEN, functional references 
such as PI, SIN(, and SEGS$( (the left parenthesis following a func- 
tion name is considered to be part of the name), and special charac- 


ters such as 


The + or - preceding a numeric constant is considered to be a separate 
entity from the number. 


Every character in a REM statement or string constant requires one 
byte. To reduce program size minimize the number of characters in 
each. 


Each use of the multiple statement line saves six bytes. The program: 


Nor 
oOo 
wD 
oil 
Ww 


takes six bytes more memory than the equivalent program 


10 A= 3\B= 4 
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When the BASIC program is running, the following additional array and 
string storage is required. For each numeric array, the number of 


bytes allocated is 
4* (SS1MAX+2) 


for a singly-dimensioned array, 


or 
4*[(SSIMAX+1) * (SS2MAX+1) +1] 


for a doubly-dimensioned array, where SSI1MAX and SS2MAX are the maxi- 
mum values of the first and second array subscripts, respectively. For 
each string array, the number of bytes allocated is 


2* (SSIMAX+2) 
for a singly-dimensioned array or 
2*[(SSIMAX+1) * (SS2MAX+1)+1] 


for a doubly-dimensioned array, where SSIMAX and SS2MAX are the maxi- 
mum values of the first and second array subscripts, respectively. 


For each non-null string scalar or array element of length N currently 
defined in the BASIC program, N+4 bytes of string storage are required. 
Null strings are not stored. The symbol table or array entry has a 
special indicator to specify a null string. 


In addition to these parameters, when an OPEN statement is executed 

a buffer is allocated from the user area if there is currently room. 
If there is no room in the user area, the buffer is allocated from a 
system I/O area common to all users (if room is available there). 
Table D-2 contains the standard buffer sizes. A nonstandard buffer 
size may be specified on nonfile-structured devices by means of the 
RECORDSIZE option in the OPEN statement. Specifying DOUBLE BUF causes 
allocation of two equal size buffers. 


MU BASIC/RT-11 Program Structure 


Table D-2 
Standard File Buffer Sizes 


| Device | Buffer Size (words) | 


| Disk 

DECtape 
| Magtape | 256 | 
| Cassette 64 


High-speed paper tape punch 
High-speed paper tape reader 
Line printer 

Card reader 


Abbreviations of device names, 2-3 

Accessing devices, 3-1 

Access to system, i-2 

Alphanumeric display terminal 
Margins, 3-8, 3-15 

Arithmetic functions, B-6 

Arithmetic operators, 1-5 

Array storage, C-2, C-3 

Array subscripts transiated into 
file addresses, C-3 

ASCII character set, A-1l 

ASR margins, 3-15 


Assembly language routines, 1-8 
Assignable devices, 3-l 

ASSIGN command, 3-3 

ASSIGNED state of device, 3-3 


At sign (@) in file descriptor, 
2-4, 2-5 


Binary files, random-access, 2-19 


Braces, B-l 
Buffer size, 2-14, D-5 
BYE command, 1-3, 2-13 
Cassette 
nonfile-structured, 2-19 
seguential files on, 2-16 
write-protected, 2-18 
CHAIN statement, 2-12 


Channel number (logical unit number), 
2-1i 
Characters in file names, 
CLEAR command, D-l 
CLOSE statement, 2-12 
Commands, 3-1 
enhancements to 
file, 2-6 
summary of, B-l, B-8 
Compatibility with single-user 
BASIC/RT~-11, 2-8 
Conventions of documentation, 
Conversion codes, ASCII/octal/ 
decimal, A-2, A-3, A-4 
CTRL/C key command, 2-12, 
CTRL/O key command disabled, 
CTRL/Q key command, 3-6 


2-9 


, 1-6 


B=-1 


3-6, 3-16 


S11 


»DAS 
Data 
Data 
Data 


(default extension), 2-8 
access in virtual arrays, 
files, 2-11 
storage, 2-l 
»-DAT (default extension), 
DEASSIGN command, 3-3 
DECwriter margins, 3-15 
Default device, 2-3 
Device assignment, 3-l 
Device names and abbreviations, 2-3 
Devices accessed by file statements 
and commands, 2-6 
Devices supported by RT-1l, 


c-4 


2-8 


iL 


Devices, system, 2-2 
Device storage allocati 
virtual files, C-4 
Dial-up terminals, 3-8 
Documentation conventions, 
Dollar sign ($) in file 
descriptor, 2-4, 2-5 
Double end-of-file, 2-16 


B-1 


Echoing of low-speed reader/ 
punch, 3-11 
Ellipsis, B-2 
End-of-file condition, 
END statement, 2-12 
Enhancements to BASIC-1l, 
Error, fatal program, 2-12 
Error messages, 4-1 
Example program demonstrating 
OPEN statement, 2-15 
Example program of octal dump, 
expression, B-2 
Extension, filename and, 
Extension specification, 


2-12 


imo 


2-24 


2-4 
2-5 
Fatal program error, 2-12 
File 
classes, 2- 
commands, 2- 
deletion, 2 ; 
descriptor, 2-2 
protection, 2-8 
renaming, 2- 
searches, 2 
Size, 2-14, 
statements, 
File addresses 
subscripts, 
File buffer 
sizes, D-5 
storage, 3-5 
Filename and extension, 
Files, 2-1 
closing, 2-12 
deletion and renaming, 
purged, 2-13 
restrictions to simultaneous 
access, 2-26 
Files 
data, 2-11 
integer virtual, 
multiple volume, 
program, 2-10 
random access binary, 
sequential data, 2~il 
sequential on magtape and 
cassette, 2-16 
virtual array, 2-19, 
File, sentinel, 2-16 
FILESIZE option, 2-14 
Fill characters, 3-8 
Floating point virtual array file, 
2-21 


rom array 


‘aa 
w < 
0) 
Qu 
rh 


2-4 


2-25 


2-20, 2-21 


2-17 


2=19 


2522 


INDEX-1 


Function calls, 3-9 
summary, 3-10 

Functions, 3-l 
arithmetic, B-6 
enhancements to, 
string, B-8 
summary of, 


1-7 
B-1, B-6 


Group files, 2-1 


Group library files, 2-4, 2-8, 2-10 


HELLO feature, 1-1 

2-12 
2-1 
2-11 


IF END # statement, 
Input and output, 
INPUT # statement, 
integer, B-2 
Integer virtual files, 
IN USE state of device, 


2-20, 2-21 


5-5 


KEY command, 3-7 
KILL statement, 
KSR margins, 3-15 


2-26 


LA3@ and LA36 margins, 3-16 

LENGTH command, 3-3 

LET statement with system function 
call, 3-9 

Library files, group and public, 
2-8, 2-10 

line number, B-2 

Logical end-of-tape, 2-16 

Logical unit number (channel number), 
2-11 


3-15, 


Log-off procedure, 1-3 
Log-on procedure, 1-2 
Lower-case letters, B-l, B-2 


Low-speed paper tape reader/punch, 

3-7 

echo enable/disable, 3-11 
Magtape, sequential files on, 2-16 
Margin setting on terminals, 

3-14, 3-15, 3-16 
Memory requirements, 3- 
Memory storage, 3-3, D- 
Messages, error, 4-1 
MODE option, 2-17, 2-18 
Multiple volume files, 


4 
2 


2217 


Named files, 2-4 

Names of devices (and abbreviations), 
2-3 

NEW command, 2-13 

Nonfile-structured OPEN statement, 
2-19 


Nonprivileged user, 2-8, 2-10 
Nonpublic devices, 3-1, 3-2, 3-3 
Number sign (#) in file descriptor, 


2-4, 2-5 


2-13 
2-11 


OLD command, 
OPEN statement, 
format, 2-13 
OPEN statement for virtual files,2-20 
OPEN statement, nonfile-structured, 
2-19 


Operators, arithmetic, 1-5 
Output speed, 2-14 
Output to terminal, 3-6 


Paper tape reader/punch, low-speed, 
3-7 
echo enable/disable, 
Password, 1-l, 1-2, 1-8 
Possible states for nonpublic 
devices, 3-2 
PRINT # statement, 2-11 
Priority of arithmetic operations, 
1-5 
Private files, 2-4, 2-8 
Privileged status set by system 
function, 3-17 
Privileged users, 
Program 
error, 
files, 2-10 
size, 3-4 
structure, D-1 
Program example demonstrating 
octal dump, 2-24 
OPEN statement, 
Programs 


gL 


1-4, 2-8, 2-10 


2-12 


2-15 


memory storage of, D-2 
renaming of, 2-25 
Public devices, 3-l 
Public files, 2-1 
Public library files, 2-4, 2-8, 2-10 
Punch, low-speed paper tape, 3-7 
echo enable/disable, 3-11 
Random access files, 2-1, 2-19 
Reader, low-speed paper tape, 3-7 
echo enable/disable, 3-ll 
READY message, 1-3, 1-4 


READY, return by system function,3-13 
Record-locking facility, 2-27 
RECORDSIZE option, 2-14 
relational operator, B-2 
REM statements, D=-2 
Renaming files or programs, 
Restricted operations, 1-4 
Restrictions to simultaneous 
file access, 2-26 
Return to RT-1ll monitor by system 
function, 3-17 
Rewind operation, 
RUBOUT key command, 


2-25 


2-17 
3=7 


INDEX-2 


SCR command, 2-13, D-l 


Searches of files, 2-18 
Sentinel file, 2-16 
Sequential files, 2-1, 2-11 


on magtape and cassette, 2-16 
SET TTY command, 3-8 
Simultaneous file access 


restrictions, 2-26 


Single-character input mode, 3-12 
Size of 

buffer, 2-14 

file, 2-14 

permanent virtual file, 2-21 


program, 3-4 
Speed of output, 2- 
Square brackets, B- 
Start procedures, 1-1 
Statements 

enhancements to, 1-7 

file, 2-6 

summary of, B-l, B-3 
Stopping terminal output, 3-6 
STOP statement, 2-12 
Storage requirements of 

BASIC program, 3-3 

virtual arrays, 2-22 
string expression, B-2 
String functions, B-=-8 
Strings in virtual files, 
String virtual array file, 
Subscripts in virtual arrays, 
Supported devices, 1-1 
Symbols, B-l 
Symbol table, D-1l 
System access, 1-2 
System buffer, 2-15 
System devices, 2-2 
System device used as default, 2-3 
System function calls, 3-9 

summary, 3-10 


14 
2 


2-20 
2221 
2-20 


TAPE command, 3-7 

Tape operations, 2-16, 2-17 

Terminal characteristics, 3-5 

Terminal, fill characters, 3-8 

Terminal margin set by system 
function, 3-14 

Terminal types, 3-8 

Terminating output at terminal, 3-6 

Terminating the session, 1-3 

Type-ahead feature, 3-5, 3-6 


Unprivileged users, 1-4 
UNSAVE command, 2-10 
Update existing sequential file, 
Upper-case letters, B-l 
User code area, D-1l 
User ID, 1-1, 1-2, 1-8 
set by system function, 3-16 
Users, privileged or unprivileged, 
1-4 


2-11 


variable, B-2 
Virtual array facility, cC-l 
accessing algorithm, C-5 
array subscripts translated to file 
addresses, C-3 
data access, C-4 
device storage, C-4 
Virtual array files, 
storage requirements, 
VTO5 and vT50 margins, 


2-1, 2-19, 2-20 
2-22 
3-157 2-16 


Words in use, number of, 3-4 
Write-protect, 2-18 


INDEX-3 
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READER'S COMMENTS 


NOTE: This form is for document comments only. Problems 
with software should be reported on a Software 
Problem Repert (SPR) form 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 


Assembly language programmer 
Higher~level language programmer 
Occasional programmer (experienced) 
User with little programming experience 


Student programmer 


OOO000 


Non-programmer interested in computer concepts and capabilities 


‘Date 


Street 
a SPO Code 
or 
Country 


If you do not require a written reply, please check here. [} 
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